AircoTool API Reference
Welkom bij de AircoTool API. Hiermee kunnen partners (installateurs en airco-leveranciers) hun productcatalogus automatisch synchroniseren met hun AircoTool-account, zodat deze verschijnt in de offerte- en adviesmodule.
De API is REST-georiënteerd, stuurt en ontvangt JSON en wordt beveiligd met
een Bearer-token per partner.
Basis-URL
Alle endpoints zijn bereikbaar onder de volgende basis-URL:
https://aircotool.nl/api/v1
Endpoints
| Methode | Endpoint | Beschrijving |
|---|---|---|
GET |
/api/v1/products |
Producten opvragen |
POST |
/api/v1/products |
Product aanmaken of bijwerken |
DELETE |
/api/v1/products/{external_id} |
Product verwijderen |
Lees eerst de authenticatie voordat je de endpoints aanroept.
Authenticatie
Elk verzoek moet een geldige API-sleutel (Bearer-token) meesturen in de
Authorization-header:
Authorization: Bearer <jouw-api-sleutel>
Rate-limit
Het API-verkeer is beperkt tot 120 verzoeken per minuut per token. Bij
overschrijding wordt een HTTP 429 teruggegeven.
Statuscodes
| Code | Betekenis |
|---|---|
200 |
OK - het verzoek is geslaagd. |
201 |
Created - het product is aangemaakt of bijgewerkt. |
401 |
Unauthorized - ontbrekende of ongeldige token. |
422 |
Unprocessable Entity - validatiefout in de payload. |
429 |
Too Many Requests - rate-limit overschreden. |
404 |
Not Found - het opgevraagde product bestaat niet. |