Dokumentaatio

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

Virhehyväksyn

Version 2 tuotantovirheen kirjekuori sisältää virheobjektin, jossa on vakaa koodi ja viestikentät.

{
  "error": {
    "code": "invalid_request",
    "message": "Check the request fields."
  }
}

Valinnainen tietoobjekti sisältää koneellisesti luettavan kontekstin, kuten retryAfterSeconds.

HTTP-vastausotsikoissa on todennus- ja uudelleenyritysten metatiedot tarvittaessa.

Vaatimääräinen virhe- kataloogi

Seuraavat koodit ovat nykyisen version 2 sopimus.

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ää 10 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	subscription_required	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	Lopeta kysely ja luo tarvittaessa uusi työpaikka
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	korvaus_loppuun	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ä uudelleen turvallisesti ja ota yhteyttä tukeen pyyntötunnuksella, jos se jatkuu

Jokaisen virheen, asiakirjan uudelleenkoettavuuden, laskutuksen, lokin näkyvyyden ja tukitietojen osalta.

Tällä sivulla