Our API is exposed as an HTTP/1 and HTTP/2 service over SSL. All endpoints live under the URL https://api.akzonobel.com/external/color/mixitbms/v1/ and then generally follow the REST architecture.
The most recent version of the Mixit BMS API is V3. We strongly recommend transitioning to this latest version. Over the next few months, the previously released versions of the Mixit BMS API will be deprecated. Consequently, continuing to utilize an older version may result in the disruption of your system. To facilitate a smooth transition, we have developed a migration path to assist you in adopting the latest version.
All requests must be encoded as JSON with the Content-Type: application/json header. Most responses, including errors, are encoded exclusively as JSON as well.
Content-Type: application/json
Provide your API token as part of the Ocp-Apim-Subscription-Key header.
If the authentication is unsuccessful, the status code 401 is returned.
Ocp-Apim-Subscription-Key: $KEY
After detecting several requests with invalid credentials within a short period, the API will temporarily reject all authentication attempts for that user (including ones with valid credentials) with
403 Forbidden.
Where possible, the API strives to use appropriate HTTP verbs for each action.
| Verb | Description |
|---|---|
| GET | Used for retrieving resources. |
| POST | Used for creating resources. |
| PUT | Used for updating resources. |
We limit the number of calls you can make over a certain period of time. Rate limits vary based on the requested endpoint and HTTP Verbs:
| Endpoint | POST | GET | PUT |
|---|---|---|---|
| Work Order | 500 | 500 | 500 |
If you exceed the rate limit, an error response returns with the status 429 Too Many Requests.
Status: 429 Too Many Requests