公共的 API · 参考 API

假设测试

假设测试的终点,包括精确的路线,参数,请求机体和可扩展的响应方案.

5 终点/api/hypothesis稳定机器可读的描述 ↗

{ }

通过可编辑的独立合同来支持本页面. 在生产使用之前,验证使用测试数据的写作操作.

/api/hypothesis

准备使用的工作流程

开始使用假设测试

使用专用API代币,首先验证测试数据的读取操作.

保存代币服务器侧,然后将其发送到Authorization标题中.
检查所需参数,并扩大请求或响应方案.
在应用错误中处理HTTP状态和稳定的error字段.

POST假设 GET标签:PATCH补丁假设

数据模型

数据结构

模型在此列出一次,并且可以直接从使用它们的终端点扩展.

Hypothesis14 字段

idinteger · int32

Id.

namestring

姓名.

previousStartDatestring · date-time

之前的开始日期.

startDatestring · date-time

开始日期.

endDatestring · date-time

终结日期.

modelIdinteger · int64

模型身份证.

modelArticlestring

标题:

viewIdinteger · int64

查看ID.

productIdinteger · int64

产品身份证

organizationIdinteger · int64

组织身份证.

createdDatestring · date-time

创造日期.

createdUserstring

创建用户.

servicestring

服务.

successStatusstring

成功状态.

FindResponseHypothesis1 字段

rowsHypothesis[]

排列.

错误合同

如何返回应用错误

编程的代码在每个地方都相同,而用户面向的消息由服务器翻译. 建立在error周围的应用逻辑,仅用于显示.

鱼类

稳定机器可读的代码用于集成逻辑.

鱼类

在API代币用户语言中显示准备的消息.

鱼类

服务器在本地化消息模板中插入的值.

文

localMessage使用了 API代币的用户的lang字段.文档语言和 Accept-Language标题不会改变它;当用户没有语言配置时,使用俄语.

RU用户位置是 ru

{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}

CN中文 (cn)

{
  "error": "error_brand_already_exists",
  "localMessage": "品牌 Base 已经存在",
  "params": {
    "name": "Base"
  }
}

终点

POST

假设

/api/hypothesis/

具有写入的标志

使用POSTX/api/hypothesis/.的假设

要求机构

application/json

对象场Hypothesis

字段	类型	必填	描述
`id`	integer · int32	否	Id.
`name`	string	否	姓名.
`previousStartDate`	string · date-time	否	之前的开始日期.
`startDate`	string · date-time	否	开始日期.
`endDate`	string · date-time	否	终结日期.
`modelId`	integer · int64	否	模型身份证.
`modelArticle`	string	否	标题:
`viewId`	integer · int64	否	查看ID.
`productId`	integer · int64	否	产品身份证
`organizationId`	integer · int64	否	组织身份证.
`createdDate`	string · date-time	否	创造日期.
`createdUser`	string	否	创建用户.
`service`	stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC	否	服务.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	否	成功状态.

curl --request POST 'https://api.selsup.ru/api/hypothesis/' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}'

const response = await fetch('https://api.selsup.ru/api/hypothesis/', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "id": 1001,
    "name": "Example",
    "previousStartDate": "2026-01-15T12:00:00Z",
    "startDate": "2026-01-15T12:00:00Z",
    "endDate": "2026-01-15T12:00:00Z",
    "modelId": 1001
  }),
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/hypothesis/', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "id": 1001,
    "name": "Example",
    "previousStartDate": "2026-01-15T12:00:00Z",
    "startDate": "2026-01-15T12:00:00Z",
    "endDate": "2026-01-15T12:00:00Z",
    "modelId": 1001
  }),
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.post(
    'https://api.selsup.ru/api/hypothesis/',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'id': 1001,
        'name': 'Example',
        'previousStartDate': '2026-01-15T12:00:00Z',
        'startDate': '2026-01-15T12:00:00Z',
        'endDate': '2026-01-15T12:00:00Z',
        'modelId': 1001
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/hypothesis/',
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
    "strings"
)

func main() {
    req, err := http.NewRequest("POST", "https://api.selsup.ru/api/hypothesis/", strings.NewReader(`{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}`))
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
    req.Header.Set("Content-Type", "application/json")

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/hypothesis/"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString("""
{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}
"""))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

成功的反应

200

对象场 Hypothesis

字段	类型	必填	描述
`id`	integer · int32	否	Id.
`name`	string	否	姓名.
`previousStartDate`	string · date-time	否	之前的开始日期.
`startDate`	string · date-time	否	开始日期.
`endDate`	string · date-time	否	终结日期.
`modelId`	integer · int64	否	模型身份证.
`modelArticle`	string	否	标题:
`viewId`	integer · int64	否	查看ID.
`productId`	integer · int64	否	产品身份证
`organizationId`	integer · int64	否	组织身份证.
`createdDate`	string · date-time	否	创造日期.
`createdUser`	string	否	创建用户.
`service`	stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC	否	服务.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	否	成功状态.

{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}

错误8

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required

需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied

拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown

发生了一个未知的错误。如果该问题再次发生，请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_empty_end_date

未指定结束日期

应用逻辑中使用稳定的error_empty_end_date代码;localMessage包含上述翻译.

400error_empty_name

没有给出名字

应用逻辑中使用稳定的error_empty_name代码;localMessage包含上述翻译.

400error_empty_start_date

未指定开始日期

应用逻辑中使用稳定的error_empty_start_date代码;localMessage包含上述翻译.

400error_end_less_then_start_date

结束日期必须大于开始日期

应用逻辑中使用稳定的error_end_less_then_start_date代码;localMessage包含上述翻译.

400error_no_client

没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

GET

const response = await fetch('https://api.selsup.ru/api/hypothesis/1001', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/hypothesis/1001', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.get(
    'https://api.selsup.ru/api/hypothesis/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/hypothesis/1001',
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("GET", "https://api.selsup.ru/api/hypothesis/1001", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/hypothesis/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

成功的反应

200

对象场 Hypothesis

字段	类型	必填	描述
`id`	integer · int32	否	Id.
`name`	string	否	姓名.
`previousStartDate`	string · date-time	否	之前的开始日期.
`startDate`	string · date-time	否	开始日期.
`endDate`	string · date-time	否	终结日期.
`modelId`	integer · int64	否	模型身份证.
`modelArticle`	string	否	标题:
`viewId`	integer · int64	否	查看ID.
`productId`	integer · int64	否	产品身份证
`organizationId`	integer · int64	否	组织身份证.
`createdDate`	string · date-time	否	创造日期.
`createdUser`	string	否	创建用户.
`service`	stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC	否	服务.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	否	成功状态.

{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}

错误4

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required

需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied

拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown

发生了一个未知的错误。如果该问题再次发生，请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_no_client

没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

PATCH

补丁假设

/api/hypothesis/{id}

具有写入的标志

使用 PATCH /api/hypothesis/{id}.的补丁假设

要求机构

application/json

对象场Hypothesis

字段	类型	必填	描述
`id`	integer · int32	否	Id.
`name`	string	否	姓名.
`previousStartDate`	string · date-time	否	之前的开始日期.
`startDate`	string · date-time	否	开始日期.
`endDate`	string · date-time	否	终结日期.
`modelId`	integer · int64	否	模型身份证.
`modelArticle`	string	否	标题:
`viewId`	integer · int64	否	查看ID.
`productId`	integer · int64	否	产品身份证
`organizationId`	integer · int64	否	组织身份证.
`createdDate`	string · date-time	否	创造日期.
`createdUser`	string	否	创建用户.
`service`	stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC	否	服务.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	否	成功状态.

curl --request PATCH 'https://api.selsup.ru/api/hypothesis/%7Bid%7D' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}'

const response = await fetch('https://api.selsup.ru/api/hypothesis/%7Bid%7D', {
  method: 'PATCH',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "id": 1001,
    "name": "Example",
    "previousStartDate": "2026-01-15T12:00:00Z",
    "startDate": "2026-01-15T12:00:00Z",
    "endDate": "2026-01-15T12:00:00Z",
    "modelId": 1001
  }),
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/hypothesis/%7Bid%7D', {
  method: 'PATCH',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "id": 1001,
    "name": "Example",
    "previousStartDate": "2026-01-15T12:00:00Z",
    "startDate": "2026-01-15T12:00:00Z",
    "endDate": "2026-01-15T12:00:00Z",
    "modelId": 1001
  }),
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.patch(
    'https://api.selsup.ru/api/hypothesis/%7Bid%7D',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'id': 1001,
        'name': 'Example',
        'previousStartDate': '2026-01-15T12:00:00Z',
        'startDate': '2026-01-15T12:00:00Z',
        'endDate': '2026-01-15T12:00:00Z',
        'modelId': 1001
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/hypothesis/%7Bid%7D',
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
    "strings"
)

func main() {
    req, err := http.NewRequest("PATCH", "https://api.selsup.ru/api/hypothesis/%7Bid%7D", strings.NewReader(`{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}`))
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
    req.Header.Set("Content-Type", "application/json")

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/hypothesis/%7Bid%7D"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("PATCH", HttpRequest.BodyPublishers.ofString("""
{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}
"""))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

成功的反应

200

对象场 Hypothesis

字段	类型	必填	描述
`id`	integer · int32	否	Id.
`name`	string	否	姓名.
`previousStartDate`	string · date-time	否	之前的开始日期.
`startDate`	string · date-time	否	开始日期.
`endDate`	string · date-time	否	终结日期.
`modelId`	integer · int64	否	模型身份证.
`modelArticle`	string	否	标题:
`viewId`	integer · int64	否	查看ID.
`productId`	integer · int64	否	产品身份证
`organizationId`	integer · int64	否	组织身份证.
`createdDate`	string · date-time	否	创造日期.
`createdUser`	string	否	创建用户.
`service`	stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC	否	服务.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	否	成功状态.

{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}

错误9

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required

需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied

拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown

发生了一个未知的错误。如果该问题再次发生，请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_empty_end_date

未指定结束日期

应用逻辑中使用稳定的error_empty_end_date代码;localMessage包含上述翻译.

400error_empty_id

未指定标识符

应用逻辑中使用稳定的error_empty_id代码;localMessage包含上述翻译.

400error_empty_name

没有给出名字

应用逻辑中使用稳定的error_empty_name代码;localMessage包含上述翻译.

400error_empty_start_date

未指定开始日期

应用逻辑中使用稳定的error_empty_start_date代码;localMessage包含上述翻译.

400error_end_less_then_start_date

结束日期必须大于开始日期

应用逻辑中使用稳定的error_end_less_then_start_date代码;localMessage包含上述翻译.

400error_no_client

没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

DELETE

删除假设

/api/hypothesis/{id}

具有写入的标志

使用 DELETE /api/hypothesis/{id}.删除假设

路径参数

字段	类型	必填	描述
`id`	integer · int32	是	Id.

curl --request DELETE 'https://api.selsup.ru/api/hypothesis/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/hypothesis/1001', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const response: Response = await fetch('https://api.selsup.ru/api/hypothesis/1001', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

import os
import requests

response = requests.delete(
    'https://api.selsup.ru/api/hypothesis/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/hypothesis/1001',
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("DELETE", "https://api.selsup.ru/api/hypothesis/1001", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/hypothesis/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("DELETE", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

成功的反应

200

答案没有身体.

错误4

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required

需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied

拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown

发生了一个未知的错误。如果该问题再次发生，请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_no_client

没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

GET

找一个

/api/hypothesis/find

读取访问的标志

使用 GET 找到 /api/hypothesis/find.

查询参数

字段	类型	必填	描述
`query`	string	否	问问.
`modelId`	integer · int64	否	模型身份证.
`service`	stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC	否	服务.
`endDateFrom`	string · date-time	否	终止日期从.
`endDateTo`	string · date-time	否	终止日期到.
`limit`	integer · int32	否	限制.
`page`	integer · int32	否	页面.
`count`	boolean	否	伯爵.
`sortBy`	stringID, NAME, CREATEDDATE, CREATEDUSER, STARTDATE, ENDDATE, PREVIOUSSTARTDATE, SUCCESSSTATUS	否	排序了.
`ascending`	boolean	否	升高.

curl --request GET 'https://api.selsup.ru/api/hypothesis/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/hypothesis/find?limit=50&page=1', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/hypothesis/find?limit=50&page=1', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.get(
    'https://api.selsup.ru/api/hypothesis/find?limit=50&page=1',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/hypothesis/find?limit=50&page=1',
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("GET", "https://api.selsup.ru/api/hypothesis/find?limit=50&page=1", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/hypothesis/find?limit=50&page=1"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

成功的反应

200

对象场 FindResponseHypothesis

字段类型必填描述

rows Hypothesis[] 否排列.

阵列项结构 Hypothesis

字段	类型	必填	描述
`id`	integer · int32	否	Id.
`name`	string	否	姓名.
`previousStartDate`	string · date-time	否	之前的开始日期.
`startDate`	string · date-time	否	开始日期.
`endDate`	string · date-time	否	终结日期.
`modelId`	integer · int64	否	模型身份证.
`modelArticle`	string	否	标题:
`viewId`	integer · int64	否	查看ID.
`productId`	integer · int64	否	产品身份证
`organizationId`	integer · int64	否	组织身份证.
`createdDate`	string · date-time	否	创造日期.
`createdUser`	string	否	创建用户.
`service`	stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC	否	服务.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	否	成功状态.

{
  "rows": "string"
}

错误4

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required

需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied

拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown

发生了一个未知的错误。如果该问题再次发生，请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_no_client

没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

假设测试

准备使用的工作流程

开始使用假设测试

数据结构

如何返回应用错误

终点

假设

要求机构

成功的反应

标签:

路径参数

成功的反应

补丁假设

要求机构

成功的反应

删除假设

路径参数

成功的反应

找一个

查询参数

成功的反应

测试请求的标志

实际请求参数

现场API响应