Welcome to Bigblue's store API documentation! This doc is aimed at developers willing to connect their e-commerce solution to Bigblue's fulfillment network.

Authentication

In order to use the API, the client will need to have an API key and secret. They must be obtained through the app beforehand, where at least one unique API key must be generated, in addition to a unique secret. Only one secret can be generated, where multiple API keys can exist at the same time. Those are like your credentials and must be kept safely.

Requests are all HTTP POST requests with a JSON body and JSON response, to this url: https://api.bigblue.co/bigblue.storeapi.v1.PublicAPI/<method>.

Every request must be authenticated with the following header:

Authorization: Bearer <api_key>

If omitted in a request, the server will return the following error

401 Unauthenticated

{
	"code": "unauthenticated",
	"msg": "Invalid API key"
}

Everything above is abstracted by using one of our soon-available client libraries for Go and Python.


Rate limiting

All the Store API endpoints are rate limited with a common threshold of 200 requests per minute.


Products