Authentication
To use the Instabee API, you need to authenticate your requests using API keys. This guide explains how to obtain and use your API keys securely.
Obtaining an API Key
Simply talk to your Implementation Manager. If you do not have a contact, please reach out to integration@instabee.com.
Your API keys carry many privileges, so be sure to keep them secure. Do not share your API keys in publicly accessible areas such as GitHub, client-side code, or in your frontend application.
Authentication Methods
All API requests must include your API key in the request headers:
1Authorization: ApiKey your_api_key_here1Authorization: ApiKey your_api_key_here
Required Headers
All API requests must include the following headers:
| Header | Value | Required | Description |
|---|---|---|---|
Authorization | ApiKey your_api_key_here | required | Authentication key for API access |
Content-Type | application/json | required | Content type for request body |
Accept-Version | 1.0.0 | required | Version of the API to be used |
Error Handling
When authentication fails, you will receive one of the following error responses:
| Status Code | Description | Resolution |
|---|---|---|
| 401 | Invalid API key | Check that your API key is correct and properly formatted |
| 403 | Insufficient permissions | Request additional permissions for your API key. Instabee controls which products and endpoints the key is valid for |