Սխալներ
Սխալները օգտագործում են ստանդարտ HTTP կարգավիճակի կոդեր և միասնական JSON մարմին։
{
"error": {
"code": "not_found",
"message": "No data found for this request. You were not charged.",
"request_id": "req_k3J9xQ2mT0aB"
}
}Միշտ գրանցեք request_id-ն։ Այն նաև x-request-id header-ում է և թույլ է տալիս աջակցությանը գտնել հենց ձեր հարցումը։
| Կարգավիճակ | Կոդ | Նշանակություն | Գանձվում է |
|---|---|---|---|
| 400 | missing_parameter / invalid_parameter / invalid_request | Պարամետրը բացակայում է կամ սխալ ձևաչափով է, օրինակ՝ VIN, որը 17 վավեր նիշ չէ։ | Ոչ |
| 401 | missing_api_key / invalid_api_key | Բանալի չի ուղարկվել, կամ բանալին սխալ է կամ չեղարկված։ | Ոչ |
| 402 | insufficient_credits | Ձեր կրեդիտների հաշվեկշիռը չի ծածկում այս հարցումը։ | Ոչ |
| 403 | account_suspended | Հաշիվը կասեցված է։ Դիմեք աջակցությանը։ | Ոչ |
| 404 | not_found / endpoint_not_found | Այս որոնման համար տվյալներ չկան, կամ երթուղին գոյություն չունի։ | Ոչ |
| 429 | rate_limited | Չափազանց շատ հարցումներ։ Պահպանեք retry-after header-ը։ | Ոչ |
| 502 | upstream_error / upstream_unreachable | Մեր տվյալների մատակարարը վերադարձրեց սխալ։ Կարելի է կրկնել։ | Ոչ |
| 503 | maintenance | Պլանային տեխնիկական աշխատանքներ։ Կրկնեք retry-after header-ով նշված ժամանակից հետո։ | Ոչ |
| 504 | upstream_timeout | Մեր տվյալների մատակարարը չափազանց երկար պատասխանեց։ Կարելի է կրկնել։ | Ոչ |
Ձախողումների մշակում
4xx-ը համարեք հարցման խնդիր։ Մի կրկնեք այն առանց փոփոխության, բացի429-ից։- Կրկնեք
502,503և504՝ էքսպոնենցիալ հետաձգմամբ։ Ձախողված փորձերի համար գումար չի գանձվում։ - Սահմանեք հաճախորդի ժամանակի սպառում առնվազն 30 վայրկյան: որոշ որոնումներ կախված են ավելի դանդաղ արտաքին աղբյուրներից։