Pannes prévisibles et faciles à suivre.

Codes HTTP conventionnels, corps uniforme et identifiant unique pour chaque requête.

Format d'erreur

403 application/json

{
  "error": {
    "code": "insufficient_scope",
    "message": "esta chave precisa do escopo commissions:read",
    "required_scope": "commissions:read"
  },
  "request_id": "req_01J..."
}

Le request_id apparaît dans l'en-tête et dans le JSON. Envoyez ce montant au support pour localiser un appel.

Codes HTTP

200SuccèsOpération terminée.

201CrééNouvelle offre en attente créée.

400Demande invalideJSON, paramètre ou URL non valide.

401Non authentifiéClé manquante, invalide, expirée ou révoquée.

402Plan requisNécessite Professionnel ou supérieur.

403Portée insuffisanteLa clé n'a pas la portée requise.

404Pas trouvéPoint de terminaison ou ressource inexistante.

413Très grand corpsLe JSON dépassait 128 Ko.

429Limite dépasséeLa clé a dépassé la fenêtre par minute.

500Erreur interneÉchec inattendu ; utilisez request_id.

Limites et en-têtes

x-ratelimit-limitLimite totale de la fenêtre

x-ratelimit-remainingDemandes restantes

x-request-idIdentification de l'appelant

cache-controlprivé, sans stockage de données authentifiées

120 req/min

La limite est par clé. Pour 429, attendez la fenêtre suivante et utilisez l'intervalle avec gigue.

Liste de contrôle de débogage

Confirmez la base https://achadu.com/api/v1.

Validez la clé avec GET /me.

Vérifiez require_scope dans 403 réponses.

Enregistrez le statut, request_id et l’heure de l’appel.

Ne répétez pas automatiquement les erreurs 400, 401, 402 ou 403.

Parlez avec le support technique →