Codes d'erreur

Comprendre les réponses d'erreur d'API

Format de réponse d'erreur
Toutes les réponses d'erreur suivent ce format :
{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "Human-readable error message"
  }
}
Codes d'erreur
400Bad Request

Les paramètres de la requête sont invalides ou incorrectement formatés.

Solution: Vérifiez le corps de votre requête et assurez-vous que tous les champs obligatoires sont présents et contiennent des valeurs valides.

401Unauthorized

Clé API invalide ou manquante.

Solution: Assurez-vous d'inclure une clé API valide dans l'en-tête Authorization.

402Payment Required

Crédits insuffisants dans votre portefeuille API.

Solution: Achetez plus de crédits ou attendez qu'ils se rechargent.

403Forbidden

Accès API non approuvé ou votre compte est suspendu.

Solution: Contactez le support si vous pensez qu'il s'agit d'une erreur.

404Not Found

La ressource demandée (tâche, webhook, etc.) est introuvable.

Solution: Vérifiez que l'identifiant de la ressource est correct.

429Too Many Requests

Trop de requêtes sur une courte période.

Solution: Implémentez un backoff exponentiel et respectez les limites de débit.

500Internal Server Error

Une erreur est survenue de notre côté.

Solution: Réessayez la requête après un court délai. Si le problème persiste, contactez le support.

Limites de taux
Limites de requêtes par défaut :
MétriqueLimite
Requêtes par minute60
Requêtes par jour10,000
Tâches simultanées5
Nano Banana Pro API