Fouten en limieten

Het formaat van een foutmelding, alle foutcodes, de snelheidslimiet per sleutel en andere limieten.

Laatst bijgewerkt: Hulp nodig? Contacteer support

Het foutformaat#

Elke fout heeft dezelfde vorm:

{
  "error": {"code": "E_SCOPE", "message": "Deze sleutel heeft de bevoegdheid invoices:read niet."},
  "request_id": "6f1c2a3e-0000-4000-8000-000000000000"
}

Gebruik code in uw programma; message is uitleg voor mensen en kan veranderen. Vermeld de request_id (ook in de header x-request-id) als u support contacteert.

Foutcodes#

HTTPCodeBetekenis
400E_VALIDATIONOngeldige invoer, bijvoorbeeld een fout limit, een ongeldige datum of een onbekende customer_id. message zegt wat.
401E_AUTHSleutel ontbreekt, is ongeldig, ingetrokken of verlopen.
403E_SCOPEDe sleutel heeft de nodige bevoegdheid niet.
404E_UNKNOWNOnbekend pad.
404E_NOT_FOUNDDe zending bestaat niet (of hoort niet bij dit bedrijf).
405E_METHODVerkeerde methode; de header Allow zegt welke wel.
413E_TOO_LARGEDe body is groter dan 64 KB.
429E_RATETe veel oproepen; zie hieronder.
500E_SERVERTijdelijke fout op de server. Probeer later opnieuw.

Snelheidslimiet#

  • Elke sleutel heeft een limiet per minuut, standaard 60 oproepen per minuut, in vaste vensters van één minuut.
  • De header x-ratelimit-limit in elk antwoord geeft de limiet van uw sleutel.
  • Bij overschrijding krijgt u 429 met E_RATE en de header Retry-After: 60. Wacht dan en probeer opnieuw.
  • Te veel oproepen met een ongeldige sleutel vanaf hetzelfde adres worden ook een tijd met 429 beantwoord.

Andere limieten#

LimietWaarde
Grootte van de body64 KB
limit per pagina1 tot 200, standaard 50
Open transportaanvragen per klant30
Actieve sleutels per bedrijf20
Webhooks per bedrijf10
Antwoordtijd van uw webhook-adres10 seconden

Logboek#

INTEGALL houdt per oproep enkel de bewerking, de status, de duur en het voorvoegsel van de sleutel bij, nooit de sleutel zelf of de inhoud. Het logboek van oproepen wordt na 90 dagen gewist.