SelSup Developers

El proyecto de ley de la Unión Europea · API Referencia

Competidores

Los puntos finales para los competidores, incluidas las rutas exactas, los parámetros, los organismos de solicitud y los esquemas de respuesta expansibles.

Puntos finales: 12/api/competitorEstablesDescripción legible por máquina ↗
{ }

Esta página está respaldada por un contrato independiente editable. Valida las operaciones de escritura con datos de prueba antes de su uso en producción.

/api/competitor

Flujos de trabajo listos para su uso

Flujos de trabajo listos para su uso

01

Comience a utilizar Competidores

Utilice un token API dedicado y valida primero las operaciones de lectura con los datos de prueba.

  1. Mantenga el token en el lado del servidor y envíelo en el encabezado Authorization.
  2. Verifique los parámetros requeridos y amplíe el esquema de solicitud o respuesta.
  3. Manejar el estado HTTP y el campo estable error en errores de aplicación.

Modelo de datos

Estructuras de datos

Los modelos se enumeran una vez aquí y también se pueden ampliar directamente desde los puntos finales que los utilizan.

Competitor10 campos
idinteger · int64

Id.

read-only
modelIdinteger · int64

Identificación de modelo.

productIdinteger · int64

Identificación del producto.

servicestring

Servicio.

Obligatorio
urlstring

- ¿Qué quieres?

Obligatorio
serviceIdstring

Identificación de servicio.

clientIdinteger · int64

Identificación del cliente.

read-only
latestPricenumber · double

El último precio.

read-only
currencystring

El dinero.

read-only
latestPriceDatestring · date-time

Última fecha de precio.

read-only
CompetitorPrice6 campos
idinteger · int64

Id.

read-only
competitorIdinteger · int64

Identificación de competidor.

Obligatorio
clientIdinteger · int64

Identificación del cliente.

read-only
pricenumber · double

El precio.

Obligatorio
currencystring

El dinero.

datestring · date-time

- ¿Qué?

CompetitorImportResult2 campos
importedinteger · int32

Importado.

skippedinteger · int32

Se saltó.

Contrato de error

Cómo se devuelven los errores de aplicación

El código error es idéntico en todas las localizaciones, mientras que el mensaje orientado al usuario es traducido por el servidor.

Exproteccion

Código estable legible por máquina para la lógica de integración.

Exproteccion

Mensaje listo para la pantalla en el idioma del usuario de tokens API.

Exproteccion

Valores interpolados por el servidor en la plantilla de mensaje localizado.

文

localMessage utiliza el campo lang del usuario que posee el token API. El lenguaje de documentación y el encabezado Accept-Language no lo cambian; el ruso se utiliza cuando el usuario no tiene un idioma configurado.

RUEl lugar del usuario es ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
ESEspañol (es)
{
  "error": "error_brand_already_exists",
  "localMessage": "La marca Base ya existe",
  "params": {
    "name": "Base"
  }
}

Puntos finales

Puntos finales

PUT

Actualización

/api/competitor/{competitorId}
Token con acceso a escribir

Actualización con PUT /api/competitor/{competitorId}.

Parámetros de trayectoria

CampoTipoObligatorioDescripción
competitorId integer · int64 Sí Identificación de competidor.

Organismo de solicitud

application/json
Campos de objetosCompetitor
CampoTipoObligatorioDescripción
id integer · int64 No Id.
modelId integer · int64 No Identificación de modelo.
productId integer · int64 No Identificación del producto.
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 Sí Servicio.
url string Sí - ¿Qué quieres?
serviceId string No Identificación de servicio.
clientId integer · int64 No Identificación del cliente.
latestPrice number · double No El último precio.
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 No El dinero.
latestPriceDate string · date-time No Última fecha de precio.
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"
}'

Respuesta exitosa

200

La respuesta no tiene cuerpo.

Errores10

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_cant_extract_tariffs
No se pueden obtener las tarifas. Escriba al soporte

error específico de punto final. Utilice el código estable error_cant_extract_tariffs en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_id_required
Se requiere id del competidor

error específico de punto final. Utilice el código estable error_competitor_id_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_not_found
Competidor no encontrado

error específico de punto final. Utilice el código estable error_competitor_not_found en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_required
Competidor obligatorio

error específico de punto final. Utilice el código estable error_competitor_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_url_required
El enlace del competidor es obligatorio

error específico de punto final. Utilice el código estable error_competitor_url_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_no_client
Cliente no encontrado o fue eliminado. Escriba al soporte

error específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_service_not_supported
Servicio no compatible

error específico de punto final. Utilice el código estable error_service_not_supported en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

DELETE

Eliminar

/api/competitor/{competitorId}
Token con acceso a escribir

Eliminar con DELETE /api/competitor/{competitorId}.

Parámetros de trayectoria

CampoTipoObligatorioDescripción
competitorId integer · int64 Sí Identificación de competidor.
curl --request DELETE 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200

La respuesta no tiene cuerpo.

Errores7

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_cant_extract_tariffs
No se pueden obtener las tarifas. Escriba al soporte

error específico de punto final. Utilice el código estable error_cant_extract_tariffs en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_id_required
Se requiere id del competidor

error específico de punto final. Utilice el código estable error_competitor_id_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_not_found
Competidor no encontrado

error específico de punto final. Utilice el código estable error_competitor_not_found en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_no_client
Cliente no encontrado o fue eliminado. Escriba al soporte

error específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

GET

¡Toda la gente !

/api/competitor/{modelId}
Token con acceso a lectura

Obtenga todo usando GET /api/competitor/{modelId}.

Parámetros de trayectoria

CampoTipoObligatorioDescripción
modelId integer · int64 Sí Identificación de modelo.
curl --request GET 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Estructura de los elementos del array Competitor[]
CampoTipoObligatorioDescripción
id integer · int64 No Id.
modelId integer · int64 No Identificación de modelo.
productId integer · int64 No Identificación del producto.
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 Sí Servicio.
url string Sí - ¿Qué quieres?
serviceId string No Identificación de servicio.
clientId integer · int64 No Identificación del cliente.
latestPrice number · double No El último precio.
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 No El dinero.
latestPriceDate string · date-time No Última fecha de precio.
[
  "string"
]
Errores6

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_cant_extract_tariffs
No se pueden obtener las tarifas. Escriba al soporte

error específico de punto final. Utilice el código estable error_cant_extract_tariffs en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_model_id_required
Se requiere id del modelo

error específico de punto final. Utilice el código estable error_model_id_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_no_client
Cliente no encontrado o fue eliminado. Escriba al soporte

error específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

POST

Crear

/api/competitor/{modelId}
Token con acceso a escribir

Crear con POST /api/competitor/{modelId}.

Parámetros de trayectoria

CampoTipoObligatorioDescripción
modelId integer · int64 Sí Identificación de modelo.

Organismo de solicitud

application/json
Campos de objetosCompetitor
CampoTipoObligatorioDescripción
id integer · int64 No Id.
modelId integer · int64 No Identificación de modelo.
productId integer · int64 No Identificación del producto.
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 Sí Servicio.
url string Sí - ¿Qué quieres?
serviceId string No Identificación de servicio.
clientId integer · int64 No Identificación del cliente.
latestPrice number · double No El último precio.
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 No El dinero.
latestPriceDate string · date-time No Última fecha de precio.
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"
}'

Respuesta exitosa

200
Campos de objetos Competitor
CampoTipoObligatorioDescripción
id integer · int64 No Id.
modelId integer · int64 No Identificación de modelo.
productId integer · int64 No Identificación del producto.
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 Sí Servicio.
url string Sí - ¿Qué quieres?
serviceId string No Identificación de servicio.
clientId integer · int64 No Identificación del cliente.
latestPrice number · double No El último precio.
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 No El dinero.
latestPriceDate string · date-time No Última fecha de precio.
{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "productId": 1001,
  "serviceId": "string"
}
Errores8

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_cant_extract_tariffs
No se pueden obtener las tarifas. Escriba al soporte

error específico de punto final. Utilice el código estable error_cant_extract_tariffs en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_required
Competidor obligatorio

error específico de punto final. Utilice el código estable error_competitor_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_url_required
El enlace del competidor es obligatorio

error específico de punto final. Utilice el código estable error_competitor_url_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_no_client
Cliente no encontrado o fue eliminado. Escriba al soporte

error específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_service_not_supported
Servicio no compatible

error específico de punto final. Utilice el código estable error_service_not_supported en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

GET

Obtenga por producto

/api/competitor/product/{productId}
Token con acceso a lectura

Obtenga por producto utilizando GET /api/competitor/product/{productId}.

Parámetros de trayectoria

CampoTipoObligatorioDescripción
productId integer · int64 Sí Identificación del producto.
curl --request GET 'https://api.selsup.ru/api/competitor/product/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Estructura de los elementos del array Competitor[]
CampoTipoObligatorioDescripción
id integer · int64 No Id.
modelId integer · int64 No Identificación de modelo.
productId integer · int64 No Identificación del producto.
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 Sí Servicio.
url string Sí - ¿Qué quieres?
serviceId string No Identificación de servicio.
clientId integer · int64 No Identificación del cliente.
latestPrice number · double No El último precio.
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 No El dinero.
latestPriceDate string · date-time No Última fecha de precio.
[
  "string"
]
Errores6

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_cant_extract_tariffs
No se pueden obtener las tarifas. Escriba al soporte

error específico de punto final. Utilice el código estable error_cant_extract_tariffs en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_no_client
Cliente no encontrado o fue eliminado. Escriba al soporte

error específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_product_not_found
Producto no encontrado

error específico de punto final. Utilice el código estable error_product_not_found en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

POST

Crear para el producto

/api/competitor/product/{productId}
Token con acceso a escribir

Crear para el producto utilizando POST /api/competitor/product/{productId}.

Parámetros de trayectoria

CampoTipoObligatorioDescripción
productId integer · int64 Sí Identificación del producto.

Organismo de solicitud

application/json
Campos de objetosCompetitor
CampoTipoObligatorioDescripción
id integer · int64 No Id.
modelId integer · int64 No Identificación de modelo.
productId integer · int64 No Identificación del producto.
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 Sí Servicio.
url string Sí - ¿Qué quieres?
serviceId string No Identificación de servicio.
clientId integer · int64 No Identificación del cliente.
latestPrice number · double No El último precio.
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 No El dinero.
latestPriceDate string · date-time No Última fecha de precio.
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"
}'

Respuesta exitosa

200
Campos de objetos Competitor
CampoTipoObligatorioDescripción
id integer · int64 No Id.
modelId integer · int64 No Identificación de modelo.
productId integer · int64 No Identificación del producto.
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 Sí Servicio.
url string Sí - ¿Qué quieres?
serviceId string No Identificación de servicio.
clientId integer · int64 No Identificación del cliente.
latestPrice number · double No El último precio.
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 No El dinero.
latestPriceDate string · date-time No Última fecha de precio.
{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "productId": 1001,
  "serviceId": "string"
}
Errores9

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_cant_extract_tariffs
No se pueden obtener las tarifas. Escriba al soporte

error específico de punto final. Utilice el código estable error_cant_extract_tariffs en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_required
Competidor obligatorio

error específico de punto final. Utilice el código estable error_competitor_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_url_required
El enlace del competidor es obligatorio

error específico de punto final. Utilice el código estable error_competitor_url_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_no_client
Cliente no encontrado o fue eliminado. Escriba al soporte

error específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_product_not_found
Producto no encontrado

error específico de punto final. Utilice el código estable error_product_not_found en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_service_not_supported
Servicio no compatible

error específico de punto final. Utilice el código estable error_service_not_supported en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

POST

Crear precios

/api/competitor/price/batch
Token con acceso a escribir

Crea precios con POST /api/competitor/price/batch.

Organismo de solicitud

application/json
Estructura de los elementos del arrayCompetitorPrice[]
CampoTipoObligatorioDescripción
id integer · int64 No Id.
competitorId integer · int64 Sí Identificación de competidor.
clientId integer · int64 No Identificación del cliente.
price number · double Sí El precio.
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 No El dinero.
date string · date-time No - ¿Qué?
curl --request POST 'https://api.selsup.ru/api/competitor/price/batch' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '[
  "string"
]'

Respuesta exitosa

200
1
Errores9

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_cant_extract_tariffs
No se pueden obtener las tarifas. Escriba al soporte

error específico de punto final. Utilice el código estable error_cant_extract_tariffs en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_id_required
Se requiere id del competidor

error específico de punto final. Utilice el código estable error_competitor_id_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_not_found
Competidor no encontrado

error específico de punto final. Utilice el código estable error_competitor_not_found en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_price_required
Introduzca un precio de competidor valido

error específico de punto final. Utilice el código estable error_competitor_price_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_prices_required
Se requieren los precios de los competidores

error específico de punto final. Utilice el código estable error_competitor_prices_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_no_client
Cliente no encontrado o fue eliminado. Escriba al soporte

error específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

POST

Competidores de importación

/api/competitor/import
Token con acceso a escribir

Importar competidores que utilizan POST /api/competitor/import.

Organismo de solicitud

multipart/form-data
CampoTipoObligatorioDescripción
file string · binary Sí El archivo.
curl --request POST 'https://api.selsup.ru/api/competitor/import' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --form 'file=@./file.bin'

Respuesta exitosa

200
Campos de objetos CompetitorImportResult
CampoTipoObligatorioDescripción
imported integer · int32 No Importado.
skipped integer · int32 No Se saltó.
{
  "imported": 1,
  "skipped": 1
}
Errores23

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_base_creating
Su panel está en proceso de creación, espere unos minutos hasta que se complete la creación del panel

error específico de punto final. Utilice el código estable error_base_creating en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_cabinet_access_denied
No tiene acceso a este espacio de trabajo.

error específico de punto final. Utilice el código estable error_cabinet_access_denied en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_cant_extract_tariffs
No se pueden obtener las tarifas. Escriba al soporte

error específico de punto final. Utilice el código estable error_cant_extract_tariffs en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_required
Competidor obligatorio

error específico de punto final. Utilice el código estable error_competitor_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_competitor_url_required
El enlace del competidor es obligatorio

error específico de punto final. Utilice el código estable error_competitor_url_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_empty_organization_form
forma de organización no especificada

error específico de punto final. Utilice el código estable error_empty_organization_form en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_empty_organization_inn
No se ha especificado INN de la organización

error específico de punto final. Utilice el código estable error_empty_organization_inn en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_empty_organization_name
No se especificó el nombre de la organización

error específico de punto final. Utilice el código estable error_empty_organization_name en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_fulfillment_client_access_denied
Fulfillment client access denied

error específico de punto final. Utilice el código estable error_fulfillment_client_access_denied en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_fulfillment_client_contract_required
Acepta el contrato para acceder a las operaciones.

error específico de punto final. Utilice el código estable error_fulfillment_client_contract_required en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_incorrect_excel
Formato de archivo incorrecto. Cargue una tabla de Excel.

error específico de punto final. Utilice el código estable error_incorrect_excel en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_max_page
El número de página no puede ser mayor a 100,000

error específico de punto final. Utilice el código estable error_max_page en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_max_upload_size_exceeded
Tamaño máximo de archivo excedido

error específico de punto final. Utilice el código estable error_max_upload_size_exceeded en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_no_client
Cliente no encontrado o fue eliminado. Escriba al soporte

error específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_organization_create_failed
Ocurrió un problema al crear la organización. Por favor, contacte al soporte

error específico de punto final. Utilice el código estable error_organization_create_failed en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_organization_exists
La organización ya está creada

error específico de punto final. Utilice el código estable error_organization_exists en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_products_not_found
Los siguientes productos no se encontraron: {products}

error específico de punto final. Utilice el código estable error_products_not_found en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_reload
La sesión de autorización ha expirado, actualice la página del navegador. Si la actualización no ayuda, intente eliminar las cookies del sitio

error específico de punto final. Utilice el código estable error_reload en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_service_not_supported
Servicio no compatible

error específico de punto final. Utilice el código estable error_service_not_supported en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_wrong_inn
INN de la organización especificado incorrectamente, longitud de 10 o 12 dígitos

error específico de punto final. Utilice el código estable error_wrong_inn en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

GET

Obtenga precios

/api/competitor/{competitorId}/price
Token con acceso a lectura

Obtenga precios con GET /api/competitor/{competitorId}/price.

Parámetros de trayectoria

CampoTipoObligatorioDescripción
competitorId integer · int64 Sí Identificación de competidor.

Parámetros de consulta

CampoTipoObligatorioDescripción
dateFrom string · date-time No La fecha de.
dateTo string · date-time No La fecha para.
curl --request GET 'https://api.selsup.ru/api/competitor/1001/price' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Estructura de los elementos del array CompetitorPrice[]
CampoTipoObligatorioDescripción
id integer · int64 No Id.
competitorId integer · int64 Sí Identificación de competidor.
clientId integer · int64 No Identificación del cliente.
price number · double Sí El precio.
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 No El dinero.
date string · date-time No - ¿Qué?
[
  "string"
]
Errores3

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

GET

Obtenga la plantilla

/api/competitor/template
Token con acceso a lectura

Obtenga la plantilla usando GET /api/competitor/template.

Parámetros de consulta

CampoTipoObligatorioDescripción
organizationId integer · int64 No Identificación de la organización.
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 No Servicio.
curl --request GET 'https://api.selsup.ru/api/competitor/template' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
"string"
Errores3

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

GET

Obtenga la colección

/api/competitor/collection
Token con acceso a lectura

Obtenga la colección usando GET /api/competitor/collection.

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

Respuesta exitosa

200
Estructura de los elementos del array Competitor[]
CampoTipoObligatorioDescripción
id integer · int64 No Id.
modelId integer · int64 No Identificación de modelo.
productId integer · int64 No Identificación del producto.
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 Sí Servicio.
url string Sí - ¿Qué quieres?
serviceId string No Identificación de servicio.
clientId integer · int64 No Identificación del cliente.
latestPrice number · double No El último precio.
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 No El dinero.
latestPriceDate string · date-time No Última fecha de precio.
[
  "string"
]
Errores5

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_cant_extract_tariffs
No se pueden obtener las tarifas. Escriba al soporte

error específico de punto final. Utilice el código estable error_cant_extract_tariffs en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_no_client
Cliente no encontrado o fue eliminado. Escriba al soporte

error específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

GET

¡Toma todo el uno!

/api/competitor/
Token con acceso a lectura

Obtenga todo 1 usando GET /api/competitor/.

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

Respuesta exitosa

200
Estructura de los elementos del array Competitor[]
CampoTipoObligatorioDescripción
id integer · int64 No Id.
modelId integer · int64 No Identificación de modelo.
productId integer · int64 No Identificación del producto.
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 Sí Servicio.
url string Sí - ¿Qué quieres?
serviceId string No Identificación de servicio.
clientId integer · int64 No Identificación del cliente.
latestPrice number · double No El último precio.
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 No El dinero.
latestPriceDate string · date-time No Última fecha de precio.
[
  "string"
]
Errores3

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

Authorization

Token para las solicitudes de ensayo

Obtener un token

El token se queda en el localStorage de este navegador y se envía solo en el encabezado Authorization de las solicitudes a api.selsup.ru.

Probar

Parámetros reales de la solicitud

Respuesta en vivo API

Envía una solicitud para ver la respuesta SelSup.