Public API · API Referencja

Badanie hipotezy

Punkty końcowe do testowania hipotezy, w tym dokładne trasy, parametry, organy żądania i rozszerzalne schematy odpowiedzi.

5 punkty końcowe/api/hypothesisStabilnyOpis czytelny maszynowo ↗

{ }

Strona ta jest wspierana przez edytowalny samodzielny kontrakt.

/api/hypothesis

Gotowe do użytkowania przepływy robocze

Zacznij używać testów hipotezy

Użyj dedykowanego tokena API i najpierw sprawdź operacje odczytu z danymi testowymi.

Trzymaj token z serwera i wysłać go w nagłówku Authorization.
Sprawdź wymagane parametry i poszerz schemat żądania lub odpowiedzi.
Zrób z statusem HTTP i stabilnym pole error w przypadku błędów aplikacyjnych.

POSTHipoteza GETId PATCHHipotesa z dodatkiem

Model danych

Struktura danych

Modele są wymienione tutaj raz i mogą być również rozszerzane bezpośrednio z punktów końcowych, które je wykorzystują.

Hypothesis14 pola

idinteger · int32

Id.

namestring

- Nazwa.

previousStartDatestring · date-time

Poprzednia data rozpoczęcia.

startDatestring · date-time

- Wczoraj.

endDatestring · date-time

Termin końcowy.

modelIdinteger · int64

Identyczny model.

modelArticlestring

Model artykułu.

viewIdinteger · int64

Id id.

productIdinteger · int64

Id produktu.

organizationIdinteger · int64

Id organizacyjny.

createdDatestring · date-time

Tworzony Termin.

createdUserstring

Tworzony Użytkownik.

servicestring

- W służbie.

successStatusstring

Status sukcesu.

FindResponseHypothesis1 pola

rowsHypothesis[]

Rzędy.

Umowa o błędzie

W jaki sposób można zwrócić błędy w aplikacji

Kod error jest identyczny w każdym miejscu, podczas gdy wiadomość skierowana do użytkownika jest tłumaczona przez serwer.

error

Stabilny kod czytelny maszynowo do logiki integracyjnej.

localMessage

Przesłanie gotowe do wyświetlania w języku użytkownika tokenu API.

params

Wartości interpołowane przez serwer w szablonie lokalizowanej wiadomości.

文

localMessage wykorzystuje pole lang użytkownika, który posiada token API. Język dokumentacji i nagłówek Accept-Language nie zmieniają go; rosyjski jest używany, gdy użytkujący nie ma konfigurowanego języka.

RULokalizacja użytkownika jest ru

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

PLPolski (pl)

{
  "error": "error_brand_already_exists",
  "localMessage": "Marka Base już istnieje",
  "params": {
    "name": "Base"
  }
}

Punkty końcowe

POST

Hipoteza

/api/hypothesis/

Token z dostępem do pisania

Hipotesa wykorzystująca POST /api/hypothesis/.

Organ wnioskujący

application/json

Połączenia obiektuHypothesis

Pole	Typ	Wymagane	Opis
`id`	integer · int32	Nie	Id.
`name`	string	Nie	- Nazwa.
`previousStartDate`	string · date-time	Nie	Poprzednia data rozpoczęcia.
`startDate`	string · date-time	Nie	- Wczoraj.
`endDate`	string · date-time	Nie	Termin końcowy.
`modelId`	integer · int64	Nie	Identyczny model.
`modelArticle`	string	Nie	Model artykułu.
`viewId`	integer · int64	Nie	Id id.
`productId`	integer · int64	Nie	Id produktu.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`createdDate`	string · date-time	Nie	Tworzony Termin.
`createdUser`	string	Nie	Tworzony Użytkownik.
`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	Nie	- W służbie.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	Nie	Status sukcesu.

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

Odpowiedź udana

200

Połączenia obiektu Hypothesis

Pole	Typ	Wymagane	Opis
`id`	integer · int32	Nie	Id.
`name`	string	Nie	- Nazwa.
`previousStartDate`	string · date-time	Nie	Poprzednia data rozpoczęcia.
`startDate`	string · date-time	Nie	- Wczoraj.
`endDate`	string · date-time	Nie	Termin końcowy.
`modelId`	integer · int64	Nie	Identyczny model.
`modelArticle`	string	Nie	Model artykułu.
`viewId`	integer · int64	Nie	Id id.
`productId`	integer · int64	Nie	Id produktu.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`createdDate`	string · date-time	Nie	Tworzony Termin.
`createdUser`	string	Nie	Tworzony Użytkownik.
`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	Nie	- W służbie.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	Nie	Status sukcesu.

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

Władze8

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_empty_end_date

Nie podano daty zakończenia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_end_date; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_name

Nie podano nazwy

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_name; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_start_date

Nie podano daty rozpoczęcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_start_date; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_end_less_then_start_date

Data zakończenia musi być większa niż data rozpoczęcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_end_less_then_start_date; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_no_client

Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

GET

Id

/api/hypothesis/{id}

Token z dostępem do odczytu

Id używający GET /api/hypothesis/{id}.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`id`	integer · int32	Tak	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());
    }
}

Odpowiedź udana

200

Połączenia obiektu Hypothesis

Pole	Typ	Wymagane	Opis
`id`	integer · int32	Nie	Id.
`name`	string	Nie	- Nazwa.
`previousStartDate`	string · date-time	Nie	Poprzednia data rozpoczęcia.
`startDate`	string · date-time	Nie	- Wczoraj.
`endDate`	string · date-time	Nie	Termin końcowy.
`modelId`	integer · int64	Nie	Identyczny model.
`modelArticle`	string	Nie	Model artykułu.
`viewId`	integer · int64	Nie	Id id.
`productId`	integer · int64	Nie	Id produktu.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`createdDate`	string · date-time	Nie	Tworzony Termin.
`createdUser`	string	Nie	Tworzony Użytkownik.
`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	Nie	- W służbie.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	Nie	Status sukcesu.

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

Władze4

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_no_client

Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

PATCH

Hipotesa z dodatkiem

/api/hypothesis/{id}

Token z dostępem do pisania

Hipotesa patch używająca PATCH /api/hypothesis/{id}.

Organ wnioskujący

application/json

Połączenia obiektuHypothesis

Pole	Typ	Wymagane	Opis
`id`	integer · int32	Nie	Id.
`name`	string	Nie	- Nazwa.
`previousStartDate`	string · date-time	Nie	Poprzednia data rozpoczęcia.
`startDate`	string · date-time	Nie	- Wczoraj.
`endDate`	string · date-time	Nie	Termin końcowy.
`modelId`	integer · int64	Nie	Identyczny model.
`modelArticle`	string	Nie	Model artykułu.
`viewId`	integer · int64	Nie	Id id.
`productId`	integer · int64	Nie	Id produktu.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`createdDate`	string · date-time	Nie	Tworzony Termin.
`createdUser`	string	Nie	Tworzony Użytkownik.
`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	Nie	- W służbie.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	Nie	Status sukcesu.

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

Odpowiedź udana

200

Połączenia obiektu Hypothesis

Pole	Typ	Wymagane	Opis
`id`	integer · int32	Nie	Id.
`name`	string	Nie	- Nazwa.
`previousStartDate`	string · date-time	Nie	Poprzednia data rozpoczęcia.
`startDate`	string · date-time	Nie	- Wczoraj.
`endDate`	string · date-time	Nie	Termin końcowy.
`modelId`	integer · int64	Nie	Identyczny model.
`modelArticle`	string	Nie	Model artykułu.
`viewId`	integer · int64	Nie	Id id.
`productId`	integer · int64	Nie	Id produktu.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`createdDate`	string · date-time	Nie	Tworzony Termin.
`createdUser`	string	Nie	Tworzony Użytkownik.
`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	Nie	- W służbie.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	Nie	Status sukcesu.

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

Władze9

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_empty_end_date

Nie podano daty zakończenia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_end_date; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_id

Nie określono identyfikatora

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_id; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_name

Nie podano nazwy

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_name; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_empty_start_date

Nie podano daty rozpoczęcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_empty_start_date; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_end_less_then_start_date

Data zakończenia musi być większa niż data rozpoczęcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_end_less_then_start_date; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_no_client

Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

DELETE

Zlikwidować hipotezę

/api/hypothesis/{id}

Token z dostępem do pisania

Usunięcie hipotezy za pomocą DELETE /api/hypothesis/{id}.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`id`	integer · int32	Tak	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());
    }
}

Odpowiedź udana

200

Odpowiedź nie ma ciała.

Władze4

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_no_client

Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

GET

Znajdź

/api/hypothesis/find

Token z dostępem do odczytu

Znajdź używając GET /api/hypothesis/find.

Parametry zapytania

Pole	Typ	Wymagane	Opis
`query`	string	Nie	- Nie wiem.
`modelId`	integer · int64	Nie	Identyczny model.
`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	Nie	- W służbie.
`endDateFrom`	string · date-time	Nie	Termin zakończenia.
`endDateTo`	string · date-time	Nie	Termin końcowy.
`limit`	integer · int32	Nie	Ogranicz.
`page`	integer · int32	Nie	Strona.
`count`	boolean	Nie	Zgromadzisz.
`sortBy`	stringID, NAME, CREATEDDATE, CREATEDUSER, STARTDATE, ENDDATE, PREVIOUSSTARTDATE, SUCCESSSTATUS	Nie	- Zarejestrowany.
`ascending`	boolean	Nie	Wzniesienie.

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

Odpowiedź udana

200

Połączenia obiektu FindResponseHypothesis

Pole Typ Wymagane Opis

rows Hypothesis[] Nie Rzędy.

Struktura pozycji zestawu Hypothesis

Pole	Typ	Wymagane	Opis
`id`	integer · int32	Nie	Id.
`name`	string	Nie	- Nazwa.
`previousStartDate`	string · date-time	Nie	Poprzednia data rozpoczęcia.
`startDate`	string · date-time	Nie	- Wczoraj.
`endDate`	string · date-time	Nie	Termin końcowy.
`modelId`	integer · int64	Nie	Identyczny model.
`modelArticle`	string	Nie	Model artykułu.
`viewId`	integer · int64	Nie	Id id.
`productId`	integer · int64	Nie	Id produktu.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`createdDate`	string · date-time	Nie	Tworzony Termin.
`createdUser`	string	Nie	Tworzony Użytkownik.
`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	Nie	- W służbie.
`successStatus`	stringNONE, SUCCESSFUL, UNSUCCESSFUL	Nie	Status sukcesu.

{
  "rows": "string"
}

Władze4

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_no_client

Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

Badanie hipotezy

Gotowe do użytkowania przepływy robocze

Zacznij używać testów hipotezy

Struktura danych

W jaki sposób można zwrócić błędy w aplikacji

Punkty końcowe

Hipoteza

Organ wnioskujący

Odpowiedź udana

Id

Parametry ścieżki

Odpowiedź udana

Hipotesa z dodatkiem

Organ wnioskujący

Odpowiedź udana

Zlikwidować hipotezę

Parametry ścieżki

Odpowiedź udana

Znajdź

Parametry zapytania

Odpowiedź udana

Token do wniosków o badania

Prawdziwe parametry żądania

Odpowiedź API