AircoTool API
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
Overzicht
| Onderdeel | Beschrijving | Documentatie |
|---|---|---|
| API Reference | Alle endpoints op een rij | API Reference |
| Authenticatie | Bearer-token en rate-limit | Authenticatie |
| Producten opvragen | Ophalen van producten | Producten opvragen |
| Product aanmaken of bijwerken | Upserten van producten | Product aanmaken of bijwerken |
| Product verwijderen | Verwijderen van producten | Product verwijderen |
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. |