API · API Đề xuất

Kiểm tra giả thuyết

Các điểm cuối cho việc thử nghiệm giả thuyết, bao gồm các tuyến đường chính xác, các tham số, các cơ quan yêu cầu và các kế hoạch phản ứng có thể mở rộng.

5 điểm cuối/api/hypothesisThường ổn địnhMô tả có thể đọc được bằng máy ↗

{ }

Trang này được hỗ trợ bởi một hợp đồng độc lập có thể chỉnh sửa. Thiết lập các hoạt động viết bằng dữ liệu thử nghiệm trước khi sử dụng sản xuất.

/api/hypothesis

Các dòng công việc sẵn sàng sử dụng

Bắt đầu sử dụng thử nghiệm giả thuyết

Sử dụng mã thông báo API chuyên dụng và xác nhận các hoạt động đọc bằng dữ liệu thử nghiệm trước.

Giữ token bên máy chủ và gửi nó trong tiêu đề Authorization.
Kiểm tra các tham số cần thiết và mở rộng quy trình yêu cầu hoặc phản hồi.
xử lý trạng thái HTTP và trường error ổn định trong lỗi ứng dụng.

POSTHiểu thuyết GETID PATCHHipote của Patch

Mô hình dữ liệu

Các cấu trúc dữ liệu

Các mô hình được liệt kê một lần ở đây và cũng có thể được mở rộng trực tiếp từ các điểm cuối sử dụng chúng.

Hypothesis14 trường

idinteger · int32

Id.

namestring

Tên.

previousStartDatestring · date-time

Ngày bắt đầu trước.

startDatestring · date-time

Ngày bắt đầu.

endDatestring · date-time

Ngày kết thúc.

modelIdinteger · int64

- Thẻ mẫu.

modelArticlestring

Mô hình Điều

viewIdinteger · int64

Xem ID.

productIdinteger · int64

Đơn vị sản phẩm

organizationIdinteger · int64

Đơn vị tổ chức.

createdDatestring · date-time

Ngày được tạo ra.

createdUserstring

Tạo User.

servicestring

Dịch vụ.

successStatusstring

Tình trạng thành công.

FindResponseHypothesis1 trường

rowsHypothesis[]

Đường.

Hợp đồng lỗi

Cách trả lại lỗi ứng dụng

Mã error giống nhau ở mọi địa điểm, trong khi thông điệp đối diện người dùng được dịch bởi máy chủ. Xây dựng logic ứng dụng xung quanh error và sử dụng localMessage chỉ cho hiển thị.

error

Mã máy tính có thể đọc ổn định cho logic tích hợp.

localMessage

Thông điệp sẵn sàng hiển thị trong ngôn ngữ của người dùng mã thông báo API.

params

Các giá trị được máy chủ liên kết vào mẫu tin nhắn địa phương.

文

localMessage sử dụng trường lang của người dùng sở hữu mã thông báo API. Ngôn ngữ tài liệu và tiêu đề Accept-Language không thay đổi nó; tiếng Nga được sử dụng khi người dùng không có ngôn ngữ được cấu hình.

RUUser locale là ru

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

VNTiếng Việt (vn)

{
  "error": "error_brand_already_exists",
  "localMessage": "Thương hiệu Base đã tồn tại",
  "params": {
    "name": "Base"
  }
}

Điểm cuối

POST

Hiểu thuyết

/api/hypothesis/

Tấm mã với quyền truy cập viết

Hiểu thuyết sử dụng POST /api/hypothesis/.

Cơ quan yêu cầu

application/json

Các trường đối tượngHypothesis

Trường	Loại	Bắt buộc	Mô tả
`id`	integer · int32	Không	Id.
`name`	string	Không	Tên.
`previousStartDate`	string · date-time	Không	Ngày bắt đầu trước.
`startDate`	string · date-time	Không	Ngày bắt đầu.
`endDate`	string · date-time	Không	Ngày kết thúc.
`modelId`	integer · int64	Không	- Thẻ mẫu.
`modelArticle`	string	Không	Mô hình Điều
`viewId`	integer · int64	Không	Xem ID.
`productId`	integer · int64	Không	Đơn vị sản phẩm
`organizationId`	integer · int64	Không	Đơn vị tổ chức.
`createdDate`	string · date-time	Không	Ngày được tạo ra.
`createdUser`	string	Không	Tạo User.
`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	Không	Dịch vụ.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	Không	Tình trạng thành công.

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());
    }
}

Phản ứng thành công

200

Các trường đối tượng Hypothesis

Trường	Loại	Bắt buộc	Mô tả
`id`	integer · int32	Không	Id.
`name`	string	Không	Tên.
`previousStartDate`	string · date-time	Không	Ngày bắt đầu trước.
`startDate`	string · date-time	Không	Ngày bắt đầu.
`endDate`	string · date-time	Không	Ngày kết thúc.
`modelId`	integer · int64	Không	- Thẻ mẫu.
`modelArticle`	string	Không	Mô hình Điều
`viewId`	integer · int64	Không	Xem ID.
`productId`	integer · int64	Không	Đơn vị sản phẩm
`organizationId`	integer · int64	Không	Đơn vị tổ chức.
`createdDate`	string · date-time	Không	Ngày được tạo ra.
`createdUser`	string	Không	Tạo User.
`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	Không	Dịch vụ.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	Không	Tình trạng thành công.

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

Hầm lẫn8

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required

Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied

Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown

Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_empty_end_date

Chưa chỉ định ngày kết thúc

error cụ thể cho điểm cuối. Sử dụng mã error_empty_end_date ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_empty_name

Tiêu đề không được chỉ định

error cụ thể cho điểm cuối. Sử dụng mã error_empty_name ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_empty_start_date

Chưa chỉ định ngày bắt đầu

error cụ thể cho điểm cuối. Sử dụng mã error_empty_start_date ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_end_less_then_start_date

Ngày kết thúc phải lớn hơn ngày bắt đầu

error cụ thể cho điểm cuối. Sử dụng mã error_end_less_then_start_date ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client

Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

GET

ID

/api/hypothesis/{id}

Tấm mã với truy cập đọc

ID sử dụng GET /api/hypothesis/{id}.

Các tham số đường

Trường	Loại	Bắt buộc	Mô tả
`id`	integer · int32	Có	Id.

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

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());
    }
}

Phản ứng thành công

200

Các trường đối tượng Hypothesis

Trường	Loại	Bắt buộc	Mô tả
`id`	integer · int32	Không	Id.
`name`	string	Không	Tên.
`previousStartDate`	string · date-time	Không	Ngày bắt đầu trước.
`startDate`	string · date-time	Không	Ngày bắt đầu.
`endDate`	string · date-time	Không	Ngày kết thúc.
`modelId`	integer · int64	Không	- Thẻ mẫu.
`modelArticle`	string	Không	Mô hình Điều
`viewId`	integer · int64	Không	Xem ID.
`productId`	integer · int64	Không	Đơn vị sản phẩm
`organizationId`	integer · int64	Không	Đơn vị tổ chức.
`createdDate`	string · date-time	Không	Ngày được tạo ra.
`createdUser`	string	Không	Tạo User.
`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	Không	Dịch vụ.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	Không	Tình trạng thành công.

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

Hầm lẫn4

401auth_required

Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied

Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown

Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_no_client

Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

PATCH

Hipote của Patch

/api/hypothesis/{id}

Tấm mã với quyền truy cập viết

Hipote của vá bằng PATCH /api/hypothesis/{id}.

Cơ quan yêu cầu

application/json

Các trường đối tượngHypothesis

Trường	Loại	Bắt buộc	Mô tả
`id`	integer · int32	Không	Id.
`name`	string	Không	Tên.
`previousStartDate`	string · date-time	Không	Ngày bắt đầu trước.
`startDate`	string · date-time	Không	Ngày bắt đầu.
`endDate`	string · date-time	Không	Ngày kết thúc.
`modelId`	integer · int64	Không	- Thẻ mẫu.
`modelArticle`	string	Không	Mô hình Điều
`viewId`	integer · int64	Không	Xem ID.
`productId`	integer · int64	Không	Đơn vị sản phẩm
`organizationId`	integer · int64	Không	Đơn vị tổ chức.
`createdDate`	string · date-time	Không	Ngày được tạo ra.
`createdUser`	string	Không	Tạo User.
`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	Không	Dịch vụ.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	Không	Tình trạng thành công.

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());
    }
}

Phản ứng thành công

200

Các trường đối tượng Hypothesis

Trường	Loại	Bắt buộc	Mô tả
`id`	integer · int32	Không	Id.
`name`	string	Không	Tên.
`previousStartDate`	string · date-time	Không	Ngày bắt đầu trước.
`startDate`	string · date-time	Không	Ngày bắt đầu.
`endDate`	string · date-time	Không	Ngày kết thúc.
`modelId`	integer · int64	Không	- Thẻ mẫu.
`modelArticle`	string	Không	Mô hình Điều
`viewId`	integer · int64	Không	Xem ID.
`productId`	integer · int64	Không	Đơn vị sản phẩm
`organizationId`	integer · int64	Không	Đơn vị tổ chức.
`createdDate`	string · date-time	Không	Ngày được tạo ra.
`createdUser`	string	Không	Tạo User.
`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	Không	Dịch vụ.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	Không	Tình trạng thành công.

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

Hầm lẫn9

401auth_required

Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied

Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown

Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_empty_end_date

Chưa chỉ định ngày kết thúc

error cụ thể cho điểm cuối. Sử dụng mã error_empty_end_date ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_empty_id

Chưa chỉ định định danh

error cụ thể cho điểm cuối. Sử dụng mã error_empty_id ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_empty_name

Tiêu đề không được chỉ định

error cụ thể cho điểm cuối. Sử dụng mã error_empty_name ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_empty_start_date

Chưa chỉ định ngày bắt đầu

error cụ thể cho điểm cuối. Sử dụng mã error_empty_start_date ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_end_less_then_start_date

Ngày kết thúc phải lớn hơn ngày bắt đầu

error cụ thể cho điểm cuối. Sử dụng mã error_end_less_then_start_date ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client

Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

DELETE

Xóa giả thuyết

/api/hypothesis/{id}

Tấm mã với quyền truy cập viết

Xóa giả thuyết bằng cách sử dụng DELETE /api/hypothesis/{id}.

Các tham số đường

Trường	Loại	Bắt buộc	Mô tả
`id`	integer · int32	Có	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());
    }
}

Phản ứng thành công

200

Phản ứng không có cơ thể.

Hầm lẫn4

401auth_required

Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied

Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown

Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_no_client

Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

GET

Tìm ra

/api/hypothesis/find

Tấm mã với truy cập đọc

Tìm bằng cách sử dụng GET /api/hypothesis/find.

Các tham số truy vấn

Trường	Loại	Bắt buộc	Mô tả
`query`	string	Không	- Tôi hỏi.
`modelId`	integer · int64	Không	- Thẻ mẫu.
`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	Không	Dịch vụ.
`endDateFrom`	string · date-time	Không	Ngày kết thúc từ.
`endDateTo`	string · date-time	Không	Ngày kết thúc.
`limit`	integer · int32	Không	Giới hạn.
`page`	integer · int32	Không	Page.
`count`	boolean	Không	- Anh đếm.
`sortBy`	stringID, NAME, CREATEDDATE, CREATEDUSER, STARTDATE, ENDDATE, PREVIOUSSTARTDATE, SUCCESSSTATUS	Không	Đặt hàng.
`ascending`	boolean	Không	Tăng lên.

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());
    }
}

Phản ứng thành công

200

Các trường đối tượng FindResponseHypothesis

Trường Loại Bắt buộc Mô tả

rows Hypothesis[] Không Đường.

Cấu trúc của mục array Hypothesis

Trường	Loại	Bắt buộc	Mô tả
`id`	integer · int32	Không	Id.
`name`	string	Không	Tên.
`previousStartDate`	string · date-time	Không	Ngày bắt đầu trước.
`startDate`	string · date-time	Không	Ngày bắt đầu.
`endDate`	string · date-time	Không	Ngày kết thúc.
`modelId`	integer · int64	Không	- Thẻ mẫu.
`modelArticle`	string	Không	Mô hình Điều
`viewId`	integer · int64	Không	Xem ID.
`productId`	integer · int64	Không	Đơn vị sản phẩm
`organizationId`	integer · int64	Không	Đơn vị tổ chức.
`createdDate`	string · date-time	Không	Ngày được tạo ra.
`createdUser`	string	Không	Tạo User.
`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	Không	Dịch vụ.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	Không	Tình trạng thành công.

{
  "rows": "string"
}

Hầm lẫn4

401auth_required

Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied

Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown

Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_no_client

Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

Kiểm tra giả thuyết

Các dòng công việc sẵn sàng sử dụng

Bắt đầu sử dụng thử nghiệm giả thuyết

Các cấu trúc dữ liệu

Cách trả lại lỗi ứng dụng

Điểm cuối

Hiểu thuyết

Cơ quan yêu cầu

Phản ứng thành công

ID

Các tham số đường

Phản ứng thành công

Hipote của Patch

Cơ quan yêu cầu

Phản ứng thành công

Xóa giả thuyết

Các tham số đường

Phản ứng thành công

Tìm ra

Các tham số truy vấn

Phản ứng thành công

Tỷ hiệu cho các yêu cầu thử nghiệm

Các tham số yêu cầu thực

Đáp lại API trực tiếp