Primii pași

Erori

Tratează erorile după statusul HTTP și nu reîncerca orbește fiecare cerere eșuată. Trimite întotdeauna Accept: application/json.

StatusCe trebuie făcut

400Parametru invalid sau limită de pagină. Corectează cererea; nu o repeta identic.

401 / 403Cheie absentă, invalidă, expirată, inactivă sau acces refuzat la sursă. Verifică răspunsul și abonamentul; nu repeta identic.

404Vehiculul sau lotul nu a fost găsit. Afișează lipsa rezultatului; nu inventa prețul.

429Limită de cereri atinsă. Respectă Retry-After când există; limitează reîncercările și ține cont de pachet.

5xx / timeoutReîncearcă doar citiri sigure, cu număr limitat de încercări. Păstrează ultima sincronizare reușită; nu înregistra chei sau răspunsuri complete în loguri.

Erori de autentificare

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" }

Citește răspunsul în siguranță

Verificările aplicației returnează de obicei un obiect cu error; erorile de framework și de gateway folosesc message.
Un gateway, un proxy sau un server web poate returna HTML, text simplu sau un corp gol chiar și când s-a cerut JSON.
Reîncearcă doar cereri GET sigure, cu un buget limitat și pauze tot mai lungi. Păstrează ultimul punct de control reușit.