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
Uniform felmeddelanden
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}De flesta fel använder error-strukturen ovan. Svar vid hastighetsbegränsning innehåller även fälten limit, remaining och reset på den översta nivån.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Vid HTTP 429-hastighetsbegränsningar ska du vänta enligt Retry-After-headern. allowance_exhausted innehåller i stället error.details.used, limit och periodEndsAt.
felkoder
Dessa felkoder använder API version 2:
| 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 5 000 tecken | Korrigera begäran |
| 400 | idempotency_key_required | 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 krävs | 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 | Stoppa statusfrågan och starta en ny order 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 | Konkurrensgräns | För många förfrågningar behandlas samtidigt | Försök igen efter att en aktiv begäran är klar |
| 429 | ersättning utmattad | 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 | Upprepa begäran och kontaktsupport med begäran ID om problemet kvarstår |
Dokument för varje fel: Kan begäran upprepas? Är tecken beräknade? Vad är i Minutes? Vilken information behöver stöd?