Authenticatie

De AircoTool API wordt beveiligd met een API-sleutel (Bearer-token) die gekoppeld is aan het partneraccount. Elk verzoek moet de sleutel meesturen in de Authorization-header.

Sleutel genereren

1. Log in op het partnerdashboard.
2. Ga naar API in het menu.
3. Klik op Sleutel genereren.
4. Kopieer de getoonde sleutel direct - om veiligheidsredenen wordt hij daarna niet opnieuw getoond.

Een bestaande sleutel intrekken doe je met Sleutel intrekken; alle lopende toegang wordt dan onmiddellijk geblokkeerd.

Verzoeken ondertekenen

Voeg de volgende header toe aan elk API-verzoek:

Authorization: Bearer <jouw-api-sleutel>

Voorbeeld

curl https://aircotool.nl/api/v1/products \
  -H "Authorization: Bearer eyJhbGciOi..."

Gebruik in de SDK

Wanneer je de sleutel via de UI genereert, zie je direct de volledige endpoint-URL (bijvoorbeeld https://aircotool.nl/api/v1/products). Deze URL bevat het v1-segment en hoort altijd samen met de Bearer-header te worden gebruikt.

Rate-limit

De API staat 120 verzoeken per minuut per token toe. Bij overschrijding wordt een HTTP 429 geretourneerd. Verdeel grote synchronisaties daarom over meerdere kleine batches.