Pradžia

Klaidos

Klaidas apdorokite pagal HTTP būseną ir niekada aklai nekartokite kiekvienos nepavykusios užklausos. Visada siųskite Accept: application/json.

BūsenaKą daryti

400Neteisingas parametras arba viršytas puslapio dydžio limitas. Pataisykite užklausą; nekartokite jos nepakeistos.

401 / 403Rakto nėra, jis neteisingas, nebegaliojantis ar neaktyvus, arba prieiga prie šaltinio uždrausta. Patikrinkite atsakymą ir prenumeratą; nekartokite nepakeitę.

404Automobilis ar lotas nerastas. Rodykite tuščią rezultatą; neišgalvokite kainos.

429Pasiektas užklausų limitas. Laikykitės Retry-After, jei jis pateiktas; naudokite ribotą atidėjimą ir atsižvelkite į savo plano limitą.

5xx / timeoutKartokite tik saugius skaitymus, su ribotu bandymų skaičiumi. Išsaugokite paskutinį sėkmingą kontrolinį tašką ir neįrašykite raktų ar pilnų atsakymų į žurnalus.

Autentifikacijos klaidos

403{ "error": "please add auth key in x-api-key header" }
403{ "error": "wrong api key" }
403{ "error": "your api subscription has expired" }
403{ "error": "your api subscription is not active" }

Saugiai skaitykite atsakymą

Programos patikrinimai paprastai grąžina objektą su error; karkaso ir šliuzo klaidos naudoja message.
Šliuzas, tarpinis serveris ar žiniatinklio serveris gali grąžinti HTML, paprastą tekstą ar tuščią turinį, net jei buvo prašyta JSON.
Kartokite tik saugias GET užklausas, su ribotu bandymų skaičiumi ir ilgėjančiais intervalais. Išsaugokite paskutinį sėkmingą kontrolinį tašką.