Erreurs et limites
Le format d'un message d'erreur, tous les codes d'erreur, la limite de débit par clé et les autres limites.
Le format des erreurs#
Chaque erreur a la même forme :
{
"error": {"code": "E_SCOPE", "message": "Deze sleutel heeft de bevoegdheid invoices:read niet."},
"request_id": "6f1c2a3e-0000-4000-8000-000000000000"
}Utilisez code dans votre programme ; message est une explication destinée aux personnes et peut changer. Indiquez le request_id (aussi dans l'en-tête x-request-id) lorsque vous contactez le support.
Codes d'erreur#
| HTTP | Code | Signification |
|---|---|---|
| 400 | E_VALIDATION | Saisie non valide, par exemple une valeur limit erronée, une date non valide ou un customer_id inconnu. message précise le problème. |
| 401 | E_AUTH | La clé est absente, non valide, révoquée ou expirée. |
| 403 | E_SCOPE | La clé n'a pas l'autorisation requise. |
| 404 | E_UNKNOWN | Chemin inconnu. |
| 404 | E_NOT_FOUND | L'envoi n'existe pas (ou n'appartient pas à cette entreprise). |
| 405 | E_METHOD | Méthode incorrecte ; l'en-tête Allow indique laquelle est acceptée. |
| 413 | E_TOO_LARGE | Le corps dépasse 64 Ko. |
| 429 | E_RATE | Trop d'appels ; voir ci-dessous. |
| 500 | E_SERVER | Erreur temporaire sur le serveur. Réessayez plus tard. |
Limite de débit#
- Chaque clé a une limite par minute, par défaut 60 appels par minute, dans des fenêtres fixes d'une minute.
- L'en-tête
x-ratelimit-limitde chaque réponse indique la limite de votre clé. - En cas de dépassement, vous recevez
429avecE_RATEet l'en-têteRetry-After: 60. Attendez alors et réessayez. - Trop d'appels avec une clé non valide depuis la même adresse reçoivent eux aussi une réponse
429pendant un certain temps.
Autres limites#
| Limite | Valeur |
|---|---|
| Taille du corps | 64 Ko |
limit par page | 1 à 200, 50 par défaut |
| Demandes de transport ouvertes par client | 30 |
| Clés actives par entreprise | 20 |
| Webhooks par entreprise | 10 |
| Temps de réponse de votre adresse de webhook | 10 secondes |
Journal#
Pour chaque appel, INTEGALL n'enregistre que l'opération, le statut, la durée et le préfixe de la clé, jamais la clé elle-même ni le contenu. Le journal des appels est supprimé après 90 jours.