SelSup Developers

Le public API · API Référence

Test de l'hypothèse

Les points d'expiration des tests d'hypothèse, y compris les routes exactes, les paramètres, les corps de requête et les schémas de réponse extensibles.

5 points de fin/api/hypothesisStableDéclaration lisible par machine ↗
{ }

Cette page est soutenue par un contrat indépendant éditable. Valider les opérations de rédaction avec des données de test avant utilisation de production.

/api/hypothesis

Flux de travail prêts à l'emploi

Flux de travail prêts à l'emploi

01

Commencez à utiliser les tests d' hypothèse

Utilisez un jeton API dédié et validez d'abord les opérations de lecture avec les données de test.

  1. Gardez le jeton côté serveur et envoyez-le dans l'en-tête Authorization.
  2. Vérifiez les paramètres requis et élargissez le schéma de demande ou de réponse.
  3. Traiter l'état HTTP et le champ stable error dans les erreurs d'application.

Modèle de données

Structures de données

Les modèles sont énumérés une fois ici et peuvent également être étendus directement depuis les terminaux qui les utilisent.

Hypothesis14 champs
idinteger · int32

Id.

namestring

Nom.

previousStartDatestring · date-time

Date de départ précédente.

startDatestring · date-time

Date de début.

endDatestring · date-time

La date de fin.

modelIdinteger · int64

Nom de modèle.

modelArticlestring

Article modèle.

viewIdinteger · int64

Voir l'identifiant.

productIdinteger · int64

Identification du produit.

organizationIdinteger · int64

Identification de l'organisation.

createdDatestring · date-time

Date créée.

createdUserstring

Créé par l'utilisateur.

servicestring

Le service.

successStatusstring

Le statut de succès.

FindResponseHypothesis1 champs
rowsHypothesis[]

Les rangées.

Contrats d'erreur

Comment les erreurs d'application sont retournées

Le code error est identique dans chaque locale, tandis que le message d'utilisateur est traduit par le serveur.

Le projet de loi

Code stable lisible par machine pour la logique d'intégration.

Le projet de loi

Message prêt à être affiché dans la langue de l'utilisateur de jeton API.

Le projet de loi

Les valeurs interpolées par le serveur dans le modèle de message localisé.

localMessage utilise le champ lang de l'utilisateur qui possède le jeton API. Le langage de documentation et l'en-tête Accept-Language ne le modifient pas; le russe est utilisé lorsque l'usager n'a pas de langue configurée.

RULocalisation de l'utilisateur est ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
FRFrançais (fr)
{
  "error": "error_brand_already_exists",
  "localMessage": "La marque Base existe déjà",
  "params": {
    "name": "Base"
  }
}

Les points de fin

Les points de fin

POST

Hypothèse

/api/hypothesis/
Token avec accès à l'écriture

Hypothèse utilisant POST /api/hypothesis/.

Organisme de demande

application/json
champs d'objetHypothesis
ChampTypeObligatoireDescription
id integer · int32 Non Id.
name string Non Nom.
previousStartDate string · date-time Non Date de départ précédente.
startDate string · date-time Non Date de début.
endDate string · date-time Non La date de fin.
modelId integer · int64 Non Nom de modèle.
modelArticle string Non Article modèle.
viewId integer · int64 Non Voir l'identifiant.
productId integer · int64 Non Identification du produit.
organizationId integer · int64 Non Identification de l'organisation.
createdDate string · date-time Non Date créée.
createdUser string Non Créé par l'utilisateur.
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 Non Le service.
successStatus stringNONE, SUCCESSFUL, UNSUCCESSFUL Non Le statut de succès.
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
}'

Réponse réussie

200
champs d'objet Hypothesis
ChampTypeObligatoireDescription
id integer · int32 Non Id.
name string Non Nom.
previousStartDate string · date-time Non Date de départ précédente.
startDate string · date-time Non Date de début.
endDate string · date-time Non La date de fin.
modelId integer · int64 Non Nom de modèle.
modelArticle string Non Article modèle.
viewId integer · int64 Non Voir l'identifiant.
productId integer · int64 Non Identification du produit.
organizationId integer · int64 Non Identification de l'organisation.
createdDate string · date-time Non Date créée.
createdUser string Non Créé par l'utilisateur.
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 Non Le service.
successStatus stringNONE, SUCCESSFUL, UNSUCCESSFUL Non Le statut de succès.
{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}
Les erreurs8

Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑

401auth_required
Autentification requise

Authorization est manquant, vide ou contient un jeton non valide.

400error_access_denied
Accès refusé

Le jeton existe, mais son rôle ne peut pas effectuer cette opération.

500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance

Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.

400error_empty_end_date
Date de fin non spécifiée

error spécifique au point final. Utilisez le code error_empty_end_date stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_empty_name
Nom non spécifié

error spécifique au point final. Utilisez le code error_empty_name stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_empty_start_date
Date de début non spécifiée

error spécifique au point final. Utilisez le code error_empty_start_date stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_end_less_then_start_date
La date de fin doit être postérieure à la date de début

error spécifique au point final. Utilisez le code error_end_less_then_start_date stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_no_client
Client introuvable ou supprimé. Écrivez au support

error spécifique au point final. Utilisez le code error_no_client stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

GET

Le code de l'emploi

/api/hypothesis/{id}
Token avec accès à la lecture

Identification utilisant GET /api/hypothesis/{id}.

Parametres de parcours

ChampTypeObligatoireDescription
id integer · int32 Oui Id.
curl --request GET 'https://api.selsup.ru/api/hypothesis/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Réponse réussie

200
champs d'objet Hypothesis
ChampTypeObligatoireDescription
id integer · int32 Non Id.
name string Non Nom.
previousStartDate string · date-time Non Date de départ précédente.
startDate string · date-time Non Date de début.
endDate string · date-time Non La date de fin.
modelId integer · int64 Non Nom de modèle.
modelArticle string Non Article modèle.
viewId integer · int64 Non Voir l'identifiant.
productId integer · int64 Non Identification du produit.
organizationId integer · int64 Non Identification de l'organisation.
createdDate string · date-time Non Date créée.
createdUser string Non Créé par l'utilisateur.
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 Non Le service.
successStatus stringNONE, SUCCESSFUL, UNSUCCESSFUL Non Le statut de succès.
{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}
Les erreurs4

Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑

401auth_required
Autentification requise

Authorization est manquant, vide ou contient un jeton non valide.

400error_access_denied
Accès refusé

Le jeton existe, mais son rôle ne peut pas effectuer cette opération.

500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance

Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.

400error_no_client
Client introuvable ou supprimé. Écrivez au support

error spécifique au point final. Utilisez le code error_no_client stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

PATCH

Hypothèse de patch

/api/hypothesis/{id}
Token avec accès à l'écriture

Hypothèse de patch à l'aide de PATCH /api/hypothesis/{id}.

Organisme de demande

application/json
champs d'objetHypothesis
ChampTypeObligatoireDescription
id integer · int32 Non Id.
name string Non Nom.
previousStartDate string · date-time Non Date de départ précédente.
startDate string · date-time Non Date de début.
endDate string · date-time Non La date de fin.
modelId integer · int64 Non Nom de modèle.
modelArticle string Non Article modèle.
viewId integer · int64 Non Voir l'identifiant.
productId integer · int64 Non Identification du produit.
organizationId integer · int64 Non Identification de l'organisation.
createdDate string · date-time Non Date créée.
createdUser string Non Créé par l'utilisateur.
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 Non Le service.
successStatus stringNONE, SUCCESSFUL, UNSUCCESSFUL Non Le statut de succès.
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
}'

Réponse réussie

200
champs d'objet Hypothesis
ChampTypeObligatoireDescription
id integer · int32 Non Id.
name string Non Nom.
previousStartDate string · date-time Non Date de départ précédente.
startDate string · date-time Non Date de début.
endDate string · date-time Non La date de fin.
modelId integer · int64 Non Nom de modèle.
modelArticle string Non Article modèle.
viewId integer · int64 Non Voir l'identifiant.
productId integer · int64 Non Identification du produit.
organizationId integer · int64 Non Identification de l'organisation.
createdDate string · date-time Non Date créée.
createdUser string Non Créé par l'utilisateur.
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 Non Le service.
successStatus stringNONE, SUCCESSFUL, UNSUCCESSFUL Non Le statut de succès.
{
  "id": 1001,
  "name": "Example",
  "previousStartDate": "2026-01-15T12:00:00Z",
  "startDate": "2026-01-15T12:00:00Z",
  "endDate": "2026-01-15T12:00:00Z",
  "modelId": 1001
}
Les erreurs9

Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑

401auth_required
Autentification requise

Authorization est manquant, vide ou contient un jeton non valide.

400error_access_denied
Accès refusé

Le jeton existe, mais son rôle ne peut pas effectuer cette opération.

500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance

Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.

400error_empty_end_date
Date de fin non spécifiée

error spécifique au point final. Utilisez le code error_empty_end_date stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_empty_id
Identifiant non spécifié

error spécifique au point final. Utilisez le code error_empty_id stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_empty_name
Nom non spécifié

error spécifique au point final. Utilisez le code error_empty_name stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_empty_start_date
Date de début non spécifiée

error spécifique au point final. Utilisez le code error_empty_start_date stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_end_less_then_start_date
La date de fin doit être postérieure à la date de début

error spécifique au point final. Utilisez le code error_end_less_then_start_date stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_no_client
Client introuvable ou supprimé. Écrivez au support

error spécifique au point final. Utilisez le code error_no_client stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

DELETE

Supprimer l'hypothèse

/api/hypothesis/{id}
Token avec accès à l'écriture

Supprimer l'hypothèse en utilisant DELETE /api/hypothesis/{id}.

Parametres de parcours

ChampTypeObligatoireDescription
id integer · int32 Oui Id.
curl --request DELETE 'https://api.selsup.ru/api/hypothesis/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Réponse réussie

200

La réponse n'a pas de corps.

Les erreurs4

Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑

401auth_required
Autentification requise

Authorization est manquant, vide ou contient un jeton non valide.

400error_access_denied
Accès refusé

Le jeton existe, mais son rôle ne peut pas effectuer cette opération.

500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance

Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.

400error_no_client
Client introuvable ou supprimé. Écrivez au support

error spécifique au point final. Utilisez le code error_no_client stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

GET

Trouver

/api/hypothesis/find
Token avec accès à la lecture

Trouver en utilisant GET /api/hypothesis/find.

Paramètres de requête

ChampTypeObligatoireDescription
query string Non Je me demande.
modelId integer · int64 Non Nom de modèle.
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 Non Le service.
endDateFrom string · date-time Non Date de fin.
endDateTo string · date-time Non La date de fin à.
limit integer · int32 Non La limite.
page integer · int32 Non Page. Je suis là.
count boolean Non Je compte.
sortBy stringID, NAME, CREATEDDATE, CREATEDUSER, STARTDATE, ENDDATE, PREVIOUSSTARTDATE, SUCCESSSTATUS Non On est sortis.
ascending boolean Non Il monte.
curl --request GET 'https://api.selsup.ru/api/hypothesis/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Réponse réussie

200
champs d'objet FindResponseHypothesis
ChampTypeObligatoireDescription
rows Hypothesis[] Non Les rangées.
Structure des éléments de l'array Hypothesis
ChampTypeObligatoireDescription
id integer · int32 Non Id.
name string Non Nom.
previousStartDate string · date-time Non Date de départ précédente.
startDate string · date-time Non Date de début.
endDate string · date-time Non La date de fin.
modelId integer · int64 Non Nom de modèle.
modelArticle string Non Article modèle.
viewId integer · int64 Non Voir l'identifiant.
productId integer · int64 Non Identification du produit.
organizationId integer · int64 Non Identification de l'organisation.
createdDate string · date-time Non Date créée.
createdUser string Non Créé par l'utilisateur.
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 Non Le service.
successStatus stringNONE, SUCCESSFUL, UNSUCCESSFUL Non Le statut de succès.
{
  "rows": "string"
}
Les erreurs4

Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑

401auth_required
Autentification requise

Authorization est manquant, vide ou contient un jeton non valide.

400error_access_denied
Accès refusé

Le jeton existe, mais son rôle ne peut pas effectuer cette opération.

500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance

Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.

400error_no_client
Client introuvable ou supprimé. Écrivez au support

error spécifique au point final. Utilisez le code error_no_client stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

Authorization

Marque pour les demandes d'essai

Le jeton reste dans le localStorage de ce navigateur et est envoyé uniquement dans l'en-tête Authorization des demandes à api.selsup.ru.

Essayer

Parametres réels de la demande

Réponse en direct API

Envoyez une demande pour voir la réponse SelSup.