Tmaniġġja żbalji mingħajr ma titlef il-kuntest tat-talba.
{
"text": "Kontenut sors kumpless fil-lingwa magħżula.",
"locale": "mt",
"mode": "simple-language"
}Eżempji SDK u cURL disponibbli
Messaġġi ta' żball uniformi
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Ħafna mill-iżbalji jużaw l-istruttura error ta' hawn fuq. It-tweġibiet tal-limitu tar-rata jinkludu wkoll l-oqsma tal-ogħla livell limit, remaining u reset.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Għal limiti tar-rata HTTP 429, stenna skont l-header Retry-After. allowance_exhausted minflok jinkludi error.details.used, limit u periodEndsAt.
Kodiċijiet tal-ħsara
Dawn il-kodiċijiet tal-iżbalji jużaw il-verżjoni 2 tal-API:
| HTTP | Kodu | Tfisser | Azzjoni tal-klijent |
|---|---|---|---|
| 400 | invalid_json | Il-korp tat-talba mhuwiex JSON validu | Ikkoreġi l-korp JSON |
| 400 | invalid_request | Field huwa nieqes, mhux magħruf jew mhux validu, jew it-test jaqbeż l-5,000 karattru | Korretta t-talba |
| 400 | idempotency_key_required | Talba għal xogħol jew lott m'għandha l-ebda Idempotenza-Key valida | Ibgħat ċavetta unika ta' mhux aktar minn 255 karattru |
| 400 | invalid_webhook_endpoint | L-endpoint tal-webhook magħżul huwa nieqes jew inattiv | Agħżel endpoint attiv jew uża polling |
| 401 | invalid_api_key | It-token Bearer huwa nieqes, invalidu jew revokat | Iċċekkja jew ibdel iċ-ċavetta API |
| 402 | billing_required | Il-kontijiet għandhom jiġu aġġornati qabel ma l-ipproċessar ikun jista' jkompli | Aġġorna l-kontijiet fl-applikazzjoni |
| 403 | abbonament meħtieġ | L-ispazju tax-xogħol m'għandux intitolament attiv | Agħżel pjan jew ikkuntattja l-appoġġ |
| 403 | email_not_verified | L-ebda email ta' sid jew amministratur ma hija vverifikata | Ivverifika email ta' kont eliġibbli |
| 404 | xogħol_mhux_misjub | L-impjieg ma jeżistix, jappartjeni għal spazju tax-xogħol ieħor, jew skada | Waqqaf il-verifika tal-istatus u ibda ordni ġdida jekk meħtieġ |
| 404 | batch_not_found | Il-lott ma jeżistix, jappartjeni għal spazju tax-xogħol ieħor, jew skada | Waqqaf il-votazzjoni u oħloq lott ġdid jekk meħtieġ |
| 429 | rate_limited | Ir-rata tat-talba intlaħqet | Irrispettaw Wara li Jinspiru |
| 429 | limitu tal-munita | Wisq talbiet qed jipproċessaw fl-istess ħin | Ipprova mill-ġdid wara li tispiċċa talba attiva |
| 429 | il-konċessjoni eżawrita | Il-limitu ta' karattri ta' kull xahar intlaħaq u użu addizzjonali mhux disponibbli jew diżattivat | Stenna għall-perjodu ta' kontijiet li jmiss jew ppermetti użu addizzjonali fuq pjan eliġibbli |
| 502 | processing_failed | Is-servizz ma setax jipproċessa t-test | Erġa' pprova t-talba u kkuntattja lill-appoġġ jekk il-problema tippersisti |
Dokument għal kull żball: Tista 'tiġi ripetuta t-talba? Is-sinjali huma kkalkulati? X'inhu fil-Minuti? Liema informazzjoni ma appoġġ bżonn?