Hantera fel utan att förlora begäran.
{
"text": "Komplext källinnehåll på det valda språket.",
"locale": "sv",
"mode": "simple-language"
}SDK- och cURL-exempel tillgängliga
Falska omvarmning
Produktionsfelkuvertet i version 2 innehåller ett felobjekt med stabila kod- och meddelandefält.
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Det valfria detaljobjektet har maskinläsbar kontext som retryAfterSeconds.
HTTP-svarsrubriker bär autentisering och försök igen metadata där så är tillämpligt.
Kravad felkatalog
Följande koder är det nuvarande version 2-kontraktet.
| HTTP | Kod | Betydelsen | Kundåtgärder |
|---|---|---|---|
| 400 | invalid_json | Begäran är inte giltig JSON | Korrigera JSON-kroppen |
| 400 | invalid_request | Ett fält saknas, är okänt eller ogiltigt, eller texten överstiger 10 000 tecken | Korrigera begäran |
| 400 | invalid_idempotency_key | En jobb- eller batchförfrågan har ingen giltig Idempotency-Key | Skicka en unik nyckel på högst 255 tecken |
| 400 | invalid_webhook_endpoint | Den valda webhook-slutpunkten saknas eller är inaktiv | Välj en aktiv slutpunkt eller använd polling |
| 401 | invalid_api_key | Bärartoken saknas, är ogiltig eller återkallad | Kontrollera eller byt ut API-nyckeln |
| 402 | billing_required | Faktureringen måste uppdateras innan behandlingen kan fortsätta | Uppdatera fakturering i applikationen |
| 403 | prenumeration_required | Arbetsytan har ingen aktiv behörighet | Välj en plan eller kontakta supporten |
| 403 | email_not_verified | Ingen ägares eller administratörs e-postadress är verifierad | Verifiera en kvalificerad e-postadress för konto |
| 404 | jobb_inte_hittad | Jobbet finns inte, tillhör en annan arbetsyta eller har löpt ut | Sluta rösta och skapa ett nytt jobb om det behövs |
| 404 | batch_not_found | Batchen finns inte, tillhör en annan arbetsyta eller har gått ut | Sluta polling och skapa en ny batch om det behövs |
| 429 | rate_limited | Begäran har uppnåtts | Respekt efter att ha försökt |
| 429 | concurrency_limit | För många förfrågningar behandlas samtidigt | Försök igen efter att en aktiv begäran är klar |
| 429 | ersättning_uttömd | Den månatliga teckengränsen är nådd och ytterligare användning är inte tillgänglig eller inaktiverad | Vänta på nästa faktureringsperiod eller aktivera ytterligare användning på en kvalificerad plan |
| 502 | processor_fellerat | Tjänsten kunde inte bearbeta texten | Försök igen på ett säkert sätt och kontakta supporten med begäran-ID om det fortsätter |
För varje fel, dokumentförsökbarhet, faktureringseffekt, loggsynlighet och supportinformation.