invalid_json
400 — Corps JSON invalide
SommaireErreurs
Erreurs
Lisez les problèmes RFC 9457 et transmettez l’identifiant de requête au support.
Format
Les erreurs suivent RFC 9457. status est le statut HTTP, code est stable et exploitable par votre programme, et requestId identifie la requête. Les erreurs de validation ajoutent une liste errors avec le chemin de chaque champ.
Diagnostic
Traitez les statuts 4xx comme des corrections à apporter à la requête. Réessayez un statut 429 ou 5xx selon Retry-After. Pour contacter le support, transmettez requestId sans joindre la clé d’API.
invalid_query
400 — Paramètres invalides
invalid_cursor
400 — Curseur invalide
missing_credentials
401 — Identifiants manquants
invalid_credentials
401 — Identifiants invalides
api_key_revoked
401 — Clé d’API révoquée
api_key_expired
401 — Clé d’API expirée
token_expired
401 — Jeton expiré
insufficient_scope
403 — Droits insuffisants
forbidden
403 — Accès refusé
plan_required
403 — Palier requis
quota_reached
403 — Quota atteint
api_key_rights_exceed_role
403 — Droits supérieurs au rôle
test_mode_unsupported
403 — Action indisponible en mode test
not_found
404 — Ressource introuvable
route_not_found
404 — Route introuvable
method_not_allowed
405 — Méthode non autorisée
code_taken
409 — Code déjà utilisé
idempotency_key_in_use
409 — Requête déjà en cours
conflict
409 — Conflit
revision_conflict
409 — Version obsolète
folder_name_taken
409 — Nom de dossier déjà utilisé
tag_name_taken
409 — Nom d’étiquette déjà utilisé
webhook_limit_reached
409 — Limite de webhooks atteinte
payload_too_large
413 — Corps trop volumineux
qr_logo_too_large
413 — Logo de QR code trop volumineux
unsupported_media_type
415 — Format non pris en charge
validation_failed
422 — Validation échouée
invalid_destination
422 — Destination invalide
idempotency_key_reused
422 — Clé d’idempotence déjà utilisée
batch_too_large
422 — Lot trop volumineux
webhook_url_refused
422 — Adresse de webhook refusée
rate_limited
429 — Débit dépassé
batch_rate_limited
429 — Débit des lots dépassé
internal_error
500 — Erreur interne
idempotency_unavailable
503 — Idempotence indisponible