Gérez les erreurs sans perdre le contexte de la demande.
{
"text": "Contenu source complexe dans la langue sélectionnée.",
"locale": "fr",
"mode": "simple-language"
}Exemples de SDK et cURL disponibles
Messages d'erreur uniformes
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}La plupart des erreurs utilisent la structure error ci-dessus. Les réponses de limitation de débit incluent aussi les champs de premier niveau limit, remaining et reset.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Pour les limitations de débit HTTP 429, attendez selon l’en-tête Retry-After. allowance_exhausted inclut à la place error.details.used, limit et periodEndsAt.
Codes d'erreur
Ces codes d'erreur utilisent la version API 2:
| HTTP | Coder | Signification | Action du client |
|---|---|---|---|
| 400 | invalid_json | Le corps de la requête n'est pas un JSON valide | Corriger le corps JSON |
| 400 | demande_invalide | Un champ est manquant, inconnu ou invalide, ou le texte dépasse 5 000 caractères | Corriger la demande |
| 400 | idempotency_key_required | Une tâche ou une demande par lots n'a pas de clé d'idempotence valide | Envoyez une clé unique de 255 caractères maximum |
| 400 | invalid_webhook_endpoint | Le point de terminaison du webhook sélectionné est manquant ou inactif | Choisissez un point de terminaison actif ou utilisez l'interrogation |
| 401 | invalid_api_key | Le jeton du porteur est manquant, invalide ou révoqué | Vérifier ou remplacer la clé API |
| 402 | facturation_required | La facturation doit être mise à jour avant que le traitement puisse continuer | Mettre à jour la facturation dans l'application |
| 403 | réquisition_required | L'espace de travail n'a aucun droit actif | Choisissez un forfait ou contactez le support |
| 403 | email_not_verified | Aucune adresse e-mail de propriétaire ou d'administrateur n'est vérifiée | Vérifier l'e-mail d'un compte éligible |
| 404 | job_not_found | Le travail n'existe pas, appartient à un autre espace de travail ou a expiré | Arrêter la requête de statut et lancer une nouvelle commande si nécessaire |
| 404 | batch_not_found | Le lot n'existe pas, appartient à un autre espace de travail ou a expiré | Arrêtez l'interrogation et créez un nouveau lot si nécessaire |
| 429 | taux_limité | Le taux de demande a été atteint | Respecter la nouvelle tentative après |
| 429 | concurrency_limit | Trop de demandes sont traitées en même temps | Réessayez une fois qu'une demande active est terminée |
| 429 | allowance_exhausted | La limite mensuelle de caractères est atteinte et l'utilisation supplémentaire est indisponible ou désactivée | Attendez la prochaine période de facturation ou activez une utilisation supplémentaire sur un forfait éligible |
| 502 | échec_traitement | Le service n'a pas pu traiter le texte | Répétez la requête et contactez le support avec l'ID de demande si le problème persiste |
Documenter chaque erreur: la requête peut-elle être répétée? Les caractères sont-ils calculés? Qu'est-ce qui est écrit dans le protocole? Quelle information le support a besoin?