SelSup Developers

Le public API · API Référence

Les concurrents

Les points de référence pour les concurrents, y compris les itinéraires exacts, les paramètres, les instances de demande et les schémas de réponse extensibles.

Les points de fin: 12/api/competitorStableDé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/competitor

Flux de travail prêts à l'emploi

Flux de travail prêts à l'emploi

01

Commencez à utiliser les concurrents

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.

Competitor10 champs
idinteger · int64

Id.

read-only
modelIdinteger · int64

Nom de modèle.

productIdinteger · int64

Identification du produit.

servicestring

Le service.

Obligatoire
urlstring

- Je vous en prie.

Obligatoire
serviceIdstring

Identification du service.

clientIdinteger · int64

Nom du client.

read-only
latestPricenumber · double

Le dernier prix.

read-only
currencystring

La monnaie.

read-only
latestPriceDatestring · date-time

La dernière date de prix.

read-only
CompetitorPrice6 champs
idinteger · int64

Id.

read-only
competitorIdinteger · int64

Identification du concurrent.

Obligatoire
clientIdinteger · int64

Nom du client.

read-only
pricenumber · double

Le prix.

Obligatoire
currencystring

La monnaie.

datestring · date-time

Une date.

CompetitorImportResult2 champs
importedinteger · int32

Ils sont importés.

skippedinteger · int32

Il a sauté.

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

PUT

Mise à jour

/api/competitor/{competitorId}
Token avec accès à l'écriture

Mise à jour à l'aide de PUT /api/competitor/{competitorId}.

Parametres de parcours

ChampTypeObligatoireDescription
competitorId integer · int64 Oui Identification du concurrent.

Organisme de demande

application/json
champs d'objetCompetitor
ChampTypeObligatoireDescription
id integer · int64 Non Id.
modelId integer · int64 Non Nom de modèle.
productId integer · int64 Non Identification du produit.
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Oui Le service.
url string Oui - Je vous en prie.
serviceId string Non Identification du service.
clientId integer · int64 Non Nom du client.
latestPrice number · double Non Le dernier prix.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Non La monnaie.
latestPriceDate string · date-time Non La dernière date de prix.
curl --request PUT 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "productId": 1001,
  "serviceId": "string"
}'

Réponse réussie

200

La réponse n'a pas de corps.

Les erreurs10

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_cant_extract_tariffs
Impossible d'obtenir les tarifs. Contactez le support

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

400error_competitor_id_required
Id du concurrent requis

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

400error_competitor_not_found
Concurrent introuvable

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

400error_competitor_required
Concurrent obligatoire

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

400error_competitor_url_required
Lien du concurrent obligatoire

error spécifique au point final. Utilisez le code error_competitor_url_required 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.

400error_service_not_supported
Service non pris en charge

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

DELETE

Supprimer

/api/competitor/{competitorId}
Token avec accès à l'écriture

Supprimer en utilisant DELETE /api/competitor/{competitorId}.

Parametres de parcours

ChampTypeObligatoireDescription
competitorId integer · int64 Oui Identification du concurrent.
curl --request DELETE 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Réponse réussie

200

La réponse n'a pas de corps.

Les erreurs7

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_cant_extract_tariffs
Impossible d'obtenir les tarifs. Contactez le support

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

400error_competitor_id_required
Id du concurrent requis

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

400error_competitor_not_found
Concurrent introuvable

error spécifique au point final. Utilisez le code error_competitor_not_found 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

Prenez tout

/api/competitor/{modelId}
Token avec accès à la lecture

Obtenez tout en utilisant GET /api/competitor/{modelId}.

Parametres de parcours

ChampTypeObligatoireDescription
modelId integer · int64 Oui Nom de modèle.
curl --request GET 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Réponse réussie

200
Structure des éléments de l'array Competitor[]
ChampTypeObligatoireDescription
id integer · int64 Non Id.
modelId integer · int64 Non Nom de modèle.
productId integer · int64 Non Identification du produit.
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Oui Le service.
url string Oui - Je vous en prie.
serviceId string Non Identification du service.
clientId integer · int64 Non Nom du client.
latestPrice number · double Non Le dernier prix.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Non La monnaie.
latestPriceDate string · date-time Non La dernière date de prix.
[
  "string"
]
Les erreurs6

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_cant_extract_tariffs
Impossible d'obtenir les tarifs. Contactez le support

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

400error_model_id_required
ID de modèle requis

error spécifique au point final. Utilisez le code error_model_id_required 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.

POST

Créer

/api/competitor/{modelId}
Token avec accès à l'écriture

Créer à l'aide de POST /api/competitor/{modelId}.

Parametres de parcours

ChampTypeObligatoireDescription
modelId integer · int64 Oui Nom de modèle.

Organisme de demande

application/json
champs d'objetCompetitor
ChampTypeObligatoireDescription
id integer · int64 Non Id.
modelId integer · int64 Non Nom de modèle.
productId integer · int64 Non Identification du produit.
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Oui Le service.
url string Oui - Je vous en prie.
serviceId string Non Identification du service.
clientId integer · int64 Non Nom du client.
latestPrice number · double Non Le dernier prix.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Non La monnaie.
latestPriceDate string · date-time Non La dernière date de prix.
curl --request POST 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "productId": 1001,
  "serviceId": "string"
}'

Réponse réussie

200
champs d'objet Competitor
ChampTypeObligatoireDescription
id integer · int64 Non Id.
modelId integer · int64 Non Nom de modèle.
productId integer · int64 Non Identification du produit.
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Oui Le service.
url string Oui - Je vous en prie.
serviceId string Non Identification du service.
clientId integer · int64 Non Nom du client.
latestPrice number · double Non Le dernier prix.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Non La monnaie.
latestPriceDate string · date-time Non La dernière date de prix.
{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "productId": 1001,
  "serviceId": "string"
}
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_cant_extract_tariffs
Impossible d'obtenir les tarifs. Contactez le support

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

400error_competitor_required
Concurrent obligatoire

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

400error_competitor_url_required
Lien du concurrent obligatoire

error spécifique au point final. Utilisez le code error_competitor_url_required 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.

400error_service_not_supported
Service non pris en charge

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

GET

Réservez le produit

/api/competitor/product/{productId}
Token avec accès à la lecture

Obtenez par produit à l'aide de GET /api/competitor/product/{productId}.

Parametres de parcours

ChampTypeObligatoireDescription
productId integer · int64 Oui Identification du produit.
curl --request GET 'https://api.selsup.ru/api/competitor/product/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Réponse réussie

200
Structure des éléments de l'array Competitor[]
ChampTypeObligatoireDescription
id integer · int64 Non Id.
modelId integer · int64 Non Nom de modèle.
productId integer · int64 Non Identification du produit.
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Oui Le service.
url string Oui - Je vous en prie.
serviceId string Non Identification du service.
clientId integer · int64 Non Nom du client.
latestPrice number · double Non Le dernier prix.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Non La monnaie.
latestPriceDate string · date-time Non La dernière date de prix.
[
  "string"
]
Les erreurs6

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_cant_extract_tariffs
Impossible d'obtenir les tarifs. Contactez le support

error spécifique au point final. Utilisez le code error_cant_extract_tariffs 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.

400error_product_not_found
Produit non trouvé

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

POST

Créer un produit

/api/competitor/product/{productId}
Token avec accès à l'écriture

Créer pour le produit à l'aide de POST /api/competitor/product/{productId}.

Parametres de parcours

ChampTypeObligatoireDescription
productId integer · int64 Oui Identification du produit.

Organisme de demande

application/json
champs d'objetCompetitor
ChampTypeObligatoireDescription
id integer · int64 Non Id.
modelId integer · int64 Non Nom de modèle.
productId integer · int64 Non Identification du produit.
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Oui Le service.
url string Oui - Je vous en prie.
serviceId string Non Identification du service.
clientId integer · int64 Non Nom du client.
latestPrice number · double Non Le dernier prix.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Non La monnaie.
latestPriceDate string · date-time Non La dernière date de prix.
curl --request POST 'https://api.selsup.ru/api/competitor/product/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "productId": 1001,
  "serviceId": "string"
}'

Réponse réussie

200
champs d'objet Competitor
ChampTypeObligatoireDescription
id integer · int64 Non Id.
modelId integer · int64 Non Nom de modèle.
productId integer · int64 Non Identification du produit.
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Oui Le service.
url string Oui - Je vous en prie.
serviceId string Non Identification du service.
clientId integer · int64 Non Nom du client.
latestPrice number · double Non Le dernier prix.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Non La monnaie.
latestPriceDate string · date-time Non La dernière date de prix.
{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "productId": 1001,
  "serviceId": "string"
}
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_cant_extract_tariffs
Impossible d'obtenir les tarifs. Contactez le support

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

400error_competitor_required
Concurrent obligatoire

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

400error_competitor_url_required
Lien du concurrent obligatoire

error spécifique au point final. Utilisez le code error_competitor_url_required 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.

400error_product_not_found
Produit non trouvé

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

400error_service_not_supported
Service non pris en charge

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

POST

Créer des prix

/api/competitor/price/batch
Token avec accès à l'écriture

Créer des prix à l'aide de POST /api/competitor/price/batch.

Organisme de demande

application/json
Structure des éléments de l'arrayCompetitorPrice[]
ChampTypeObligatoireDescription
id integer · int64 Non Id.
competitorId integer · int64 Oui Identification du concurrent.
clientId integer · int64 Non Nom du client.
price number · double Oui Le prix.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Non La monnaie.
date string · date-time Non Une date.
curl --request POST 'https://api.selsup.ru/api/competitor/price/batch' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '[
  "string"
]'

Réponse réussie

200
1
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_cant_extract_tariffs
Impossible d'obtenir les tarifs. Contactez le support

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

400error_competitor_id_required
Id du concurrent requis

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

400error_competitor_not_found
Concurrent introuvable

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

400error_competitor_price_required
Saisissez un prix concurrent valide

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

400error_competitor_prices_required
Les prix des concurrents sont requis

error spécifique au point final. Utilisez le code error_competitor_prices_required 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.

POST

Concurrents à l'importation

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

Les concurrents important POST /api/competitor/import.

Organisme de demande

multipart/form-data
ChampTypeObligatoireDescription
file string · binary Oui Le dossier.
curl --request POST 'https://api.selsup.ru/api/competitor/import' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --form 'file=@./file.bin'

Réponse réussie

200
champs d'objet CompetitorImportResult
ChampTypeObligatoireDescription
imported integer · int32 Non Ils sont importés.
skipped integer · int32 Non Il a sauté.
{
  "imported": 1,
  "skipped": 1
}
Les erreurs23

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_base_creating
Votre espace personnel est en cours de création, attendez quelques minutes jusqu'à la création complète de l'espace

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

400error_cabinet_access_denied
Vous ne pouvez pas accéder à cet espace de travail.

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

400error_cant_extract_tariffs
Impossible d'obtenir les tarifs. Contactez le support

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

400error_competitor_required
Concurrent obligatoire

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

400error_competitor_url_required
Lien du concurrent obligatoire

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

400error_empty_organization_form
forme d'organisation non spécifiée

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

400error_empty_organization_inn
INN de l'organisation non spécifié

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

400error_empty_organization_name
Nom de l'organisation non spécifié

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

400error_fulfillment_client_access_denied
Fulfillment client access denied

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

400error_fulfillment_client_contract_required
Acceptez le contrat pour acc\xe9der aux op\xe9rations.

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

400error_incorrect_excel
Format de fichier incorrect. Téléchargez un tableau Excel.

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

400error_max_page
Le numéro de page ne peut pas dépasser 100 000

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

400error_max_upload_size_exceeded
Taille de fichier autorisée dépassée

error spécifique au point final. Utilisez le code error_max_upload_size_exceeded 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.

400error_organization_create_failed
Un problème est survenu lors de la création de l'organisation. Veuillez contacter le support

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

400error_organization_exists
Organisation déjà créée

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

400error_products_not_found
Les produits suivants sont introuvables : {products}

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

400error_reload
La session d'autorisation a expiré, actualisez la page du navigateur. Si l'actualisation ne fonctionne pas, essayez de supprimer les cookies du site

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

400error_service_not_supported
Service non pris en charge

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

400error_wrong_inn
INN de l'organisation incorrectement spécifié, longueur de 10 ou 12 chiffres

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

GET

Obtenez des prix

/api/competitor/{competitorId}/price
Token avec accès à la lecture

Obtenez des prix à l'aide de GET /api/competitor/{competitorId}/price.

Parametres de parcours

ChampTypeObligatoireDescription
competitorId integer · int64 Oui Identification du concurrent.

Paramètres de requête

ChampTypeObligatoireDescription
dateFrom string · date-time Non Date de.
dateTo string · date-time Non À la date.
curl --request GET 'https://api.selsup.ru/api/competitor/1001/price' \
  --header 'Authorization: YOUR_API_TOKEN'

Réponse réussie

200
Structure des éléments de l'array CompetitorPrice[]
ChampTypeObligatoireDescription
id integer · int64 Non Id.
competitorId integer · int64 Oui Identification du concurrent.
clientId integer · int64 Non Nom du client.
price number · double Oui Le prix.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Non La monnaie.
date string · date-time Non Une date.
[
  "string"
]
Les erreurs3

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.

GET

Obtenez le modèle

/api/competitor/template
Token avec accès à la lecture

Obtenez le modèle à l'aide de GET /api/competitor/template.

Paramètres de requête

ChampTypeObligatoireDescription
organizationId integer · int64 Non Identification de l'organisation.
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Non Le service.
curl --request GET 'https://api.selsup.ru/api/competitor/template' \
  --header 'Authorization: YOUR_API_TOKEN'

Réponse réussie

200
"string"
Les erreurs3

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.

GET

Réservez des collections

/api/competitor/collection
Token avec accès à la lecture

Obtenez pour la collecte à l'aide de GET /api/competitor/collection.

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

Réponse réussie

200
Structure des éléments de l'array Competitor[]
ChampTypeObligatoireDescription
id integer · int64 Non Id.
modelId integer · int64 Non Nom de modèle.
productId integer · int64 Non Identification du produit.
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Oui Le service.
url string Oui - Je vous en prie.
serviceId string Non Identification du service.
clientId integer · int64 Non Nom du client.
latestPrice number · double Non Le dernier prix.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Non La monnaie.
latestPriceDate string · date-time Non La dernière date de prix.
[
  "string"
]
Les erreurs5

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_cant_extract_tariffs
Impossible d'obtenir les tarifs. Contactez le support

error spécifique au point final. Utilisez le code error_cant_extract_tariffs 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

Prenez tout le 1

/api/competitor/
Token avec accès à la lecture

Obtenez tout 1 à l'aide de GET /api/competitor/.

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

Réponse réussie

200
Structure des éléments de l'array Competitor[]
ChampTypeObligatoireDescription
id integer · int64 Non Id.
modelId integer · int64 Non Nom de modèle.
productId integer · int64 Non Identification du produit.
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, TEKSHER, KONTUR_LOGISTICS, KONTUR_EDI, VSE_INSTRUMENTI, ELECTRONIC_SIGN Oui Le service.
url string Oui - Je vous en prie.
serviceId string Non Identification du service.
clientId integer · int64 Non Nom du client.
latestPrice number · double Non Le dernier prix.
currency stringRUB, USD, EUR, AUD, AZN, GBP, AMD, BYN, BGN, BRL, HUF, VND, HKD, GEL, DKK, AED, EGP, INR, IDR, KZT, CAD, QAR, KGS, CNY, MDL, NZD, NOK, PLN, RON, XDR, SGD, TJS, THB, TRY, TMT, UZS, UAH, CZK, SEK, CHF, RSD, ZAR, KRW, JPY Non La monnaie.
latestPriceDate string · date-time Non La dernière date de prix.
[
  "string"
]
Les erreurs3

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.

Authorization

Marque pour les demandes d'essai

Obtenir un jeton

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.