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
Enveloppe d'erreur
L'enveloppe d'erreur de production de la version 2 contient un objet d'erreur avec des champs de code et de message stables.
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}L'objet de détails facultatif contient un contexte lisible par machine tel que retryAfterSeconds.
Les en-têtes de réponse HTTP contiennent des métadonnées d’authentification et de nouvelle tentative, le cas échéant.
Catalogue d'erreurs requis
Les codes suivants correspondent au contrat actuel de la version 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 10 000 caractères | Corriger la demande |
| 400 | invalid_idempotency_key | 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 | abonnement_obligatoire | 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êtez le sondage et créez un nouvel emploi 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 | limite_de concurrence | Trop de demandes sont traitées en même temps | Réessayez une fois qu'une demande active est terminée |
| 429 | allocation_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éessayez en toute sécurité et contactez l'assistance avec l'ID de demande si cela continue |
Pour chaque erreur, possibilité de réessayer le document, effet de facturation, visibilité des journaux et informations d'assistance.