GOSBI CONNECT

Gosbi Connect is the commercial name of the GOSBI - API REST. An open web service with the following features:

• Protocol: HTTP
• Document exchange format: JSON
• Gosbi server URL: https://api.gosbi.com

To work with the Gosbi API you need an authentication token. If you are an authorised distributor, this token will be provided by the person in charge of your commercial account. If you are an authorised professional (Points of Sale, Veterinarians, Breeders, Shelters, ...), in the Professionals section we explain how to obtain it.

The Gosbi server waits for the authentication token in all API requests. It must be sent in an HTTP header of the request with the name X-Authorization-Id.

All API requests must contain the following headers:

• X-Authorization-Id: With the authorisation token.
• Accept-Language: ISO 639-1 code of the language in which the request is to be received.
• Content-Type: (If applicable) application/json

Throughout this documentation, the following information will be provided for each request:

General request data:

• Url: url detail of the specific resource. Ex /b2b/3rd/order.
• Method: HTTP method used by the resource. Ej: POST
• Data: (If applicable) JSON document to be sent with the request. Ex: {"id": 5}

Description of data to be sent and/or received:

Field	Type	Description
id	int	Unique Gosbi product ID
name	str	Product name

Example using CURL of the request to be sent:

Another option provided by the Gosbi API is the possibility of "subscribing" to certain events (from now on Webhooks). In the same way as the previous point, for each available webhook, an example of the request to be received will be documented with a CURL: