Fillimi
Gabimet
Kodet e statusit ndjekin semantikën HTTP. Trupi është JSON në një nga tri forma, prandaj lexoni fushën që është e pranishme në vend që të mbështeteni te një e vetme.
| Statusi | Kuptimi | Riprovim? |
|---|---|---|
200 | Sukses. Një rezultat bosh është gjithsesi 200 me data: [] ose count: 0. | — |
400 | Motori i kërkimit e refuzoi query-n, ose një limit/scroll_time eksportimi është mbi maksimumin. | Jo, rregulloni kërkesën |
403 | Problem me çelësin, abonimin, IP-në ose aksesin te burimi. Gjithashtu një kursor eksportimi i pavlefshëm. | Jo |
404 | Automjeti, shpallja ose hyrja e fjalorit nuk u gjet në shtrirjen e burimeve tuaja, ose një kursor eksportimi i skaduar. | Jo |
422 | Validimi dështoi. errors emërton secilën fushë. | Jo, rregulloni fushat |
503 | Kërkimi është përkohësisht i padisponueshëm. Respektoni Retry-After (sekonda). | Po, pas vonesës |
429 / 5xx | Dështim i shërbimit upstream ose i infrastrukturës. Trupi mund të jetë HTML. | Po, me backoff të kufizuar |
Format e trupit
| Forma | Përdoret për |
|---|---|
{"error": "…"} | Dështime aksesi dhe kërkimi. Shpesh kthen kontekst si car_id, vin, domain_id ose ip. |
{"errors": {"field": ["…"]}} | Validimi. message është i pranishëm te disa endpoint-e dhe mungon te të tjerët. Mesazhet ndjekin lang. |
{"message": "…"} | Gabimet e kufijve të eksportimit (me your_value dhe default_value) dhe dështimet e framework-ut. |
Nuk ka kufi fiks kërkesash në minutë te rrugët publike, por kufijtë e llogarisë dhe të shërbimeve upstream mund të zbatohen gjithsesi. Respektoni gjithmonë Retry-After kur është i pranishëm.
Trajtimi i gabimeve me riprovime
# --retry repeats 429 and 5xx responses and honors Retry-After.
# --fail-with-body exits non-zero on 4xx/5xx but still prints the JSON.
curl -sg --fail-with-body --retry 3 \
"https://api.lotarius.com/search?perPage=1&api_key=$CARS_API_KEY" \
-H "Accept: application/json"422 · perPage=1Live
{
"errors": {
"perPage": [
"The per page field must be at least 2."
]
}
}