Käsittele virheitä menetämättä pyyntökohtia.
{
"text": "Monimutkainen lähdesisältö valitulla kielellä.",
"locale": "fi",
"mode": "simple-language"
}SDK- ja cURL-esimerkkejä saatavilla
Yhtenäiset virheilmoitukset
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Useimmat virheet käyttävät yllä olevaa error-rakennetta. Nopeusrajoitusvastaukset sisältävät lisäksi ylätason kentät limit, remaining ja reset.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Odota HTTP 429 -nopeusrajoituksissa Retry-After-otsakkeen mukaisesti. allowance_exhausted sisältää sen sijaan kentät error.details.used, limit ja periodEndsAt.
Virheesäännöt
Nämä virha-koodit käyttävät API -versio 2:
| HTTP | Koodi | Ymmärrettä | Asiakkaan toiminta |
|---|---|---|---|
| 400 | invalid_json | Pyynnön runko ei ole kelvollinen JSON | Korjaa JSON-runko |
| 400 | invalid_request | Kenttä puuttuu, tuntematon tai virheellinen, tai teksti ylittää 5 000 merkkiä | Korjaa pyyntö |
| 400 | virheellinen_idempotenssiavain | Työ- tai eräpyynnöllä ei ole kelvollista Idempotency-avainta | Lähetä yksilöllinen avain, jossa on enintään 255 merkkiä |
| 400 | invalid_webhook_endpoint | Valittu webhook-päätepiste puuttuu tai ei ole aktiivinen | Valitse aktiivinen päätepiste tai käytä kyselyä |
| 401 | virheellinen_api_avain | Kantaja-tunnus puuttuu, virheellinen tai peruutettu | Tarkista tai vaihda API-avain |
| 402 | billing_required | Laskutus on päivitettävä ennen kuin käsittelyä voidaan jatkaa | Päivitä laskutus sovelluksessa |
| 403 | feature_not_available | Työtilalla ei ole aktiivisia oikeuksia | Valitse suunnitelma tai ota yhteyttä tukeen |
| 403 | email_not_verified | Omistajan tai järjestelmänvalvojan sähköpostiosoitetta ei ole vahvistettu | Vahvista kelvollinen tilin sähköpostiosoite |
| 404 | job_not_found | Työtä ei ole olemassa, se kuuluu toiseen työtilaan tai on vanhentunut | Pysäytä tilakysely ja aloita tarvittaessa uusi tilaus |
| 404 | batch_not_found | Erää ei ole olemassa, se kuuluu toiseen työtilaan tai se on vanhentunut | Lopeta kysely ja luo tarvittaessa uusi erä |
| 429 | rate_limited | Pyyntömäärä on saavutettu | Kunnioitetaan sitä jälkeen |
| 429 | concurrency_limit | Liian monta pyyntöä käsitellään samanaikaisesti | Yritä uudelleen, kun aktiivinen pyyntö on päättynyt |
| 429 | allowance_exhausted | Kuukausittainen merkkirajoitus on saavutettu, ja lisäkäyttö ei ole käytettävissä tai se on poistettu käytöstä | Odota seuraavaa laskutuskautta tai ota lisäkäyttö käyttöön kelvollisella sopimuksella |
| 502 | processing_failed | Palvelu ei voinut käsitellä tekstiä | Yritä pyyntöä uudelleen ja ota yhteyttä tukeen, jos ongelma jatkuu |
Kirjoita jokaisesta virheestä: voidaanko kysyä uudelleen? Laskevatko merkkejä? Mitä protokollassa sanotaan? Millaisia tietoja tukeen tarvitaan?