GOSBI CONNECT

Gosbi Connect es el nombre comercial de la API - REST de GOSBI. Un servicio web abierto con las siguientes características:

• Protocolo: HTTP
• Formato de intercambio de documentos: JSON
• Url servidor Gosbi: https://api.gosbi.com

Para trabajar con la API de Gosbi es necesario disponer de un token de autenticación. Si eres distribuïdor autorizado, dicho token te lo proporcionará la persona que lleve tu cuenta comercial. Si eres un profesional autorizado (Puntos de Venta, Veterinarios, Criadores, Protectoras, ...), en el apartado Profesionales te explicamos cómo obtenerlo.

El servidor de Gosbi espera el token de autenticación en todas las peticiones a la API. Se debe de enviar en una cabecera HTTP de la petición con el nombre X-Authorization-Id.

Todas las peticiones a la API deben contener las siguientes cabeceras:

• X-Authorization-Id: Con el token de autorización.
• Accept-Language: Código ISO 639-1 del idioma en el que se quiere recibir la petición.
• Content-Type: (Si corresponde) application/json

A lo largo de esta documentación, se facilitará la siguiente información por cada petición:

Datos generales de petición:

• Url: Detalle de url del recurso concreto. Ej: /b2b/3rd/order.
• Method: Método HTTP utilizado por el recurso. Ej: POST
• Data: (Si corresponde) Documento JSON a enviar junto a la petición. Ej: {"id": 5}

Descripción de datos a enviar y/o recibir:

Campo	Tipo	Descripción
id	int	Id Gosbi única de producto
name	str	Nombre de producto

Ejemplo mediante CURL de la petición a enviar:

Otra opción que da la API Gosbi es la posibilidad de "suscribirse" a determinados eventos (de ahora en adelante Webhooks). De la misma forma que el punto anteriror, por cada webhook disponible se documentará con un ejemplo mediante CURL de la petición que se va a recibir: