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
01
Comience a utilizar Fabricantes
Utilice un token API dedicado y valida primero las operaciones de lectura con los datos de prueba.
Mantenga el token en el lado del servidor y envíelo en el encabezado Authorization.
Verifique los parámetros requeridos y amplíe el esquema de solicitud o respuesta.
Manejar el estado HTTP y el campo estable error en errores de aplicación.
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
Campo
Tipo
Obligatorio
Descripción
manufacturerId
integer · int32
Sí
Identificación del fabricante.
curl --request GET 'https://api.selsup.ru/api/manufacturer/1001' \
--header 'Authorization: YOUR_API_TOKEN'
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}.
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}.
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
Campo
Tipo
Obligatorio
Descripció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'
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.