Fouten en limieten
Het formaat van een foutmelding, alle foutcodes, de snelheidslimiet per sleutel en andere limieten.
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#
| HTTP | Code | Betekenis |
|---|---|---|
| 400 | E_VALIDATION | Ongeldige invoer, bijvoorbeeld een fout limit, een ongeldige datum of een onbekende customer_id. message zegt wat. |
| 401 | E_AUTH | Sleutel ontbreekt, is ongeldig, ingetrokken of verlopen. |
| 403 | E_SCOPE | De sleutel heeft de nodige bevoegdheid niet. |
| 404 | E_UNKNOWN | Onbekend pad. |
| 404 | E_NOT_FOUND | De zending bestaat niet (of hoort niet bij dit bedrijf). |
| 405 | E_METHOD | Verkeerde methode; de header Allow zegt welke wel. |
| 413 | E_TOO_LARGE | De body is groter dan 64 KB. |
| 429 | E_RATE | Te veel oproepen; zie hieronder. |
| 500 | E_SERVER | Tijdelijke 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-limitin elk antwoord geeft de limiet van uw sleutel. - Bij overschrijding krijgt u
429metE_RATEen de headerRetry-After: 60. Wacht dan en probeer opnieuw. - Te veel oproepen met een ongeldige sleutel vanaf hetzelfde adres worden ook een tijd met
429beantwoord.
Andere limieten#
| Limiet | Waarde |
|---|---|
| Grootte van de body | 64 KB |
limit per pagina | 1 tot 200, standaard 50 |
| Open transportaanvragen per klant | 30 |
| Actieve sleutels per bedrijf | 20 |
| Webhooks per bedrijf | 10 |
| Antwoordtijd van uw webhook-adres | 10 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.