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
Uniforme foutmeldingen
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}De meeste fouten gebruiken de bovenstaande error-structuur. Reacties op snelheidslimieten bevatten ook de velden limit, remaining en reset op het hoogste niveau.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Wacht bij HTTP 429-snelheidslimieten volgens de Retry-After-header. allowance_exhausted bevat in plaats daarvan error.details.used, limit en periodEndsAt.
Foutcodes
Deze foutcodes gebruiken API versie 2:
| 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 5.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 de statusvraag en start indien nodig een nieuwe bestelling |
| 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 | concurrency limiet | Er worden te veel verzoeken tegelijkertijd verwerkt | Probeer het opnieuw nadat een actief verzoek is voltooid |
| 429 | 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 de aanvraag opnieuw en neem contact op met support als het probleem aanhoudt |
Document voor elke fout: Kan het verzoek worden herhaald? Zijn de tekens berekend? Wat staat er in de notulen? Welke informatie heeft ondersteuning nodig?