Beheer fouten zonder de context van de aanvraag te verliezen.
{
"text": "Complexe broninhoud in de geselecteerde taal.",
"locale": "nl",
"mode": "simple-language"
}SDK- en cURL-voorbeelden beschikbaar
Fouten envelop
De productiefoutenvelop van versie 2 bevat een foutobject met stabiele code en berichtvelden.
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Het optionele detailsobject bevat een door een machine leesbare context, zoals retryAfterSeconds.
HTTP-antwoordheaders bevatten authenticatie en proberen metagegevens opnieuw uit te voeren, indien van toepassing.
Verplicht foutcatalogus
De volgende codes zijn het huidige versie 2-contract.
| HTTP | Code | Betekenis | Klantenhandeling |
|---|---|---|---|
| 400 | invalid_json | De aanvraagtekst is geen geldige JSON | Corrigeer de JSON-hoofdtekst |
| 400 | invalid_request | Een veld ontbreekt, is onbekend of ongeldig, of de tekst telt meer dan 10.000 tekens | Verwijder het verzoek |
| 400 | ongeldige_idempotentie_sleutel | Een taak- of batchaanvraag heeft geen geldige Idempotency-Key | Stuur een unieke sleutel van maximaal 255 tekens |
| 400 | ongeldig_webhook_eindpunt | Het geselecteerde webhookeindpunt ontbreekt of is inactief | Kies een actief eindpunt of gebruik polling |
| 401 | ongeldige_api_key | Het Bearer-token ontbreekt, is ongeldig of is ingetrokken | Controleer of vervang de API-sleutel |
| 402 | facturering_vereist | De facturering moet worden bijgewerkt voordat de verwerking kan worden voortgezet | Update de facturering in de applicatie |
| 403 | abonnement_vereist | De werkruimte heeft geen actief recht | Kies een abonnement of neem contact op met ondersteuning |
| 403 | e-mail_niet_geverifieerd | Er is geen e-mailadres van de eigenaar of beheerder geverifieerd | Verifieer een in aanmerking komend account-e-mailadres |
| 404 | vacature_niet_gevonden | De taak bestaat niet, behoort tot een andere werkruimte of is verlopen | Stop met pollen en creëer indien nodig een nieuwe baan |
| 404 | batch_not_found | De batch bestaat niet, behoort tot een andere werkruimte of is verlopen | Stop met het pollen en maak indien nodig een nieuwe batch |
| 429 | tarief_beperkt | Het aanvraagpercentage is bereikt | Respect na het terugproberen |
| 429 | gelijktijdigheid_limiet | Er worden te veel verzoeken tegelijkertijd verwerkt | Probeer het opnieuw nadat een actief verzoek is voltooid |
| 429 | toelage_uitgeput | De maandelijkse tekenlimiet is bereikt en extra gebruik is niet beschikbaar of uitgeschakeld | Wacht op de volgende factureringsperiode of schakel extra gebruik in voor een in aanmerking komend abonnement |
| 502 | processing_failed | De service kon de tekst niet verwerken | Probeer het veilig opnieuw en neem contact op met de ondersteuning met de aanvraag-ID als het probleem zich blijft voordoen |
Voor elke fout: herkansing van documenten, factureringseffect, zichtbaarheid van logboeken en ondersteuningsinformatie.