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.

Dernière mise à jour: Besoin d'aide ? Contactez le support

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#

HTTPCodeSignification
400E_VALIDATIONSaisie non valide, par exemple une valeur limit erronée, une date non valide ou un customer_id inconnu. message précise le problème.
401E_AUTHLa clé est absente, non valide, révoquée ou expirée.
403E_SCOPELa clé n'a pas l'autorisation requise.
404E_UNKNOWNChemin inconnu.
404E_NOT_FOUNDL'envoi n'existe pas (ou n'appartient pas à cette entreprise).
405E_METHODMéthode incorrecte ; l'en-tête Allow indique laquelle est acceptée.
413E_TOO_LARGELe corps dépasse 64 Ko.
429E_RATETrop d'appels ; voir ci-dessous.
500E_SERVERErreur 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-limit de chaque réponse indique la limite de votre clé.
  • En cas de dépassement, vous recevez 429 avec E_RATE et l'en-tête Retry-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 429 pendant un certain temps.

Autres limites#

LimiteValeur
Taille du corps64 Ko
limit par page1 à 200, 50 par défaut
Demandes de transport ouvertes par client30
Clés actives par entreprise20
Webhooks par entreprise10
Temps de réponse de votre adresse de webhook10 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.