Grenzen, foutmeldingen en netjes bevragen

Hoe vaak u mag vragen

Er geldt een grens per token, ruim genoeg voor een koppeling die elk kwartier kijkt en te krap voor iets dat in een lus draait. Gaat u eroverheen, dan krijgt u 429 terug met een Retry-After-kop erbij; wacht dat aantal seconden en probeer opnieuw.

Loopt u er regelmatig tegenaan, dan is dat bijna altijd een teken dat de koppeling te vaak vraagt in plaats van dat de grens te laag staat. Kom er toch niet uit, mail ons dan.

Wat de foutcodes betekenen

Code	Betekenis	Wat te doen
401	Geen of onbekend token.	Controleer de Authorization-kop. Is het token misschien vervangen?
403	Uw pakket bevat de API niet.	Kies een pakket met API, of neem contact op.
404	Niet gevonden binnen uw account.	Controleer de naam of het nummer. Een domein van een ander bestaat voor u niet.
429	Te veel verzoeken.	Wacht zoals Retry-After zegt.
5xx	Er ging iets mis bij ons.	Probeer het later opnieuw, met een oplopende wachttijd.

Netjes bevragen

• Vraag alleen wat nieuw is. Gebruik since= met het tijdstip van uw vorige ophaalronde in plaats van telkens alles.
• Elk kwartier is ruim voldoende. Rapporten komen in golven binnen, meestal een paar keer per dag. Vaker vragen levert dezelfde antwoorden op.
• Wacht langer na een fout. Verdubbel de wachttijd bij herhaalde mislukking in plaats van meteen opnieuw te proberen.
• Bewaar wat u ophaalde. Rapporten veranderen niet meer nadat ze verwerkt zijn.

Vaak is een webhook beter

Wilt u vooral wéten wanneer er iets binnenkomt, stel dan bij Instellingen een webhook in. Wij sturen dan een bericht zodra er een rapport verwerkt is, in plaats van dat u blijft vragen of er al iets is. Dat scheelt verkeer aan beide kanten en u bent sneller op de hoogte. De API blijft dan over voor wat u erna wilt ophalen.