SelSup Developers

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

Fabricantes

Puntos finales para los fabricantes, incluidas las rutas exactas, los parámetros, los organismos de solicitud y los esquemas de respuesta expansibles.

5 puntos finales/api/manufacturerEstablesDescripció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/manufacturer

Flujos de trabajo listos para su uso

Flujos de trabajo listos para su uso

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.

Manufacturer11 campos
manufacturerIdinteger · int32

Identificación del fabricante.

titlestring

El título.

namestring

- ¿Cómo se llama?

Obligatorio
addressstring

La dirección.

organizationIdinteger · int64

Identificación de la organización.

clientIdinteger · int64

Identificación del cliente.

read-only
countryIdinteger · int32

Identificación del país.

countryNamestring

Nombre del país.

read-only
innstring

Alojamiento.

deletedboolean

Se borró.

oneCIdstring

Un informador.

FindResponseManufacturer1 campos
rowsManufacturer[]

Las filas.

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

GET

Obtenga el fabricante por identificación

/api/manufacturer/{manufacturerId}
Token con acceso a lectura

Obtenga el Productor por ID utilizando GET /api/manufacturer/{manufacturerId}.

Parámetros de trayectoria

CampoTipoObligatorioDescripción
manufacturerId integer · int32 Identificación del fabricante.
curl --request GET 'https://api.selsup.ru/api/manufacturer/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Campos de objetos Manufacturer
CampoTipoObligatorioDescripción
manufacturerId integer · int32 No Identificación del fabricante.
title string No El título.
name string - ¿Cómo se llama?
address string No La dirección.
organizationId integer · int64 No Identificación de la organización.
clientId integer · int64 No Identificación del cliente.
countryId integer · int32 No Identificación del país.
countryName string No Nombre del país.
inn string No Alojamiento.
deleted boolean No Se borró.
oneCId string No Un informador.
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}
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_manufacturer_not_found
Fabricante no encontrado: {id}

error específico de punto final. Utilice el código estable error_manufacturer_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.

400error_subscription_expired
Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

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

PUT

Actualización del fabricante

/api/manufacturer/{manufacturerId}
Token con acceso a escribir

Actualización del fabricante utilizando PUT /api/manufacturer/{manufacturerId}.

Parámetros de trayectoria

CampoTipoObligatorioDescripción
manufacturerId integer · int64 Identificación del fabricante.

Organismo de solicitud

application/json
Campos de objetosManufacturer
CampoTipoObligatorioDescripción
manufacturerId integer · int32 No Identificación del fabricante.
title string No El título.
name string - ¿Cómo se llama?
address string No La dirección.
organizationId integer · int64 No Identificación de la organización.
clientId integer · int64 No Identificación del cliente.
countryId integer · int32 No Identificación del país.
countryName string No Nombre del país.
inn string No Alojamiento.
deleted boolean No Se borró.
oneCId string No Un informador.
curl --request PUT 'https://api.selsup.ru/api/manufacturer/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}'

Respuesta exitosa

200
Campos de objetos Manufacturer
CampoTipoObligatorioDescripción
manufacturerId integer · int32 No Identificación del fabricante.
title string No El título.
name string - ¿Cómo se llama?
address string No La dirección.
organizationId integer · int64 No Identificación de la organización.
clientId integer · int64 No Identificación del cliente.
countryId integer · int32 No Identificación del país.
countryName string No Nombre del país.
inn string No Alojamiento.
deleted boolean No Se borró.
oneCId string No Un informador.
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}
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_empty_manufacturer_name
No se especificó el nombre del fabricante

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

400error_manufacturer_already_exist
Ya existe un fabricante con el nombre {name}

error específico de punto final. Utilice el código estable error_manufacturer_already_exist 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_subscription_expired
Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

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

DELETE

Descargar el fabricante

/api/manufacturer/{manufacturerId}
Token con acceso a escribir

Retirado del fabricante utilizando DELETE /api/manufacturer/{manufacturerId}.

Parámetros de trayectoria

CampoTipoObligatorioDescripción
manufacturerId integer · int32 Identificación del fabricante.

Parámetros de consulta

CampoTipoObligatorioDescripción
deleted boolean Se borró.
curl --request DELETE 'https://api.selsup.ru/api/manufacturer/1001?deleted=false' \
  --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.

POST

Crear el fabricante

/api/manufacturer
Token con acceso a escribir

Creación de fabricante con POST /api/manufacturer.

Organismo de solicitud

application/json
Campos de objetosManufacturer
CampoTipoObligatorioDescripción
manufacturerId integer · int32 No Identificación del fabricante.
title string No El título.
name string - ¿Cómo se llama?
address string No La dirección.
organizationId integer · int64 No Identificación de la organización.
clientId integer · int64 No Identificación del cliente.
countryId integer · int32 No Identificación del país.
countryName string No Nombre del país.
inn string No Alojamiento.
deleted boolean No Se borró.
oneCId string No Un informador.
curl --request POST 'https://api.selsup.ru/api/manufacturer' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}'

Respuesta exitosa

200
Campos de objetos Manufacturer
CampoTipoObligatorioDescripción
manufacturerId integer · int32 No Identificación del fabricante.
title string No El título.
name string - ¿Cómo se llama?
address string No La dirección.
organizationId integer · int64 No Identificación de la organización.
clientId integer · int64 No Identificación del cliente.
countryId integer · int32 No Identificación del país.
countryName string No Nombre del país.
inn string No Alojamiento.
deleted boolean No Se borró.
oneCId string No Un informador.
{
  "name": "Example",
  "manufacturerId": 1001,
  "title": "Example",
  "address": "string",
  "organizationId": 1001,
  "clientId": 1001
}
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_empty_manufacturer_name
No se especificó el nombre del fabricante

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

400error_manufacturer_already_exist
Ya existe un fabricante con el nombre {name}

error específico de punto final. Utilice el código estable error_manufacturer_already_exist 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_subscription_expired
Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

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

GET

Encuentra

/api/manufacturer/find
Token con acceso a lectura

Encontrar usando GET /api/manufacturer/find.

Parámetros de consulta

CampoTipoObligatorioDescripción
query string No - ¿Qué quieres decir?
manufacturerOneCId string No El fabricante 1 Cd.
limit integer · int32 No El límite.
page integer · int32 No Página.
count boolean No Conde.
sortBy stringMANUFACTURERID, NAME No Se ha ordenado.
ascending boolean No Ascendiendo.
curl --request GET 'https://api.selsup.ru/api/manufacturer/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Campos de objetos FindResponseManufacturer
CampoTipoObligatorioDescripción
rows Manufacturer[] No Las filas.
Estructura de los elementos del array Manufacturer
CampoTipoObligatorioDescripción
manufacturerId integer · int32 No Identificación del fabricante.
title string No El título.
name string - ¿Cómo se llama?
address string No La dirección.
organizationId integer · int64 No Identificación de la organización.
clientId integer · int64 No Identificación del cliente.
countryId integer · int32 No Identificación del país.
countryName string No Nombre del país.
inn string No Alojamiento.
deleted boolean No Se borró.
oneCId string No Un informador.
{
  "rows": "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_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_subscription_expired
Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

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

Authorization

Token para las solicitudes de ensayo

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.