Қателер
Әрбір сәтсіздік — тұрақты, машинамен оқылатын коды бар RFC 7807 мәселе құжаты.
Мәселе мәліметтері
2xx емес жауаптар application/problem+json форматында келеді: status, title, detail, тұрақты code (snake_case), қате сұрау қасиетін атайтын міндетті емес field және қолдау қызметіне хабарласқанда көрсететін traceId.
{
"type": "https://dubaitrip.com/docs/api/errors#price_changed",
"title": "Price changed",
"status": 409,
"detail": "The fare is now 412.50 USD (was 398.00 USD). Re-price and confirm.",
"code": "price_changed",
"traceId": "00-3f2a…"
}Кездесетін кодтар
401 api_key_invalid, api_signature_invalid, api_timestamp_skew, api_nonce_reused, api_token_invalid — аутентификация мәселелері. 403 api_scope_missing (кілтіңізде scope жоқ), api_ip_not_allowed, api_partner_suspended. 429 api_rate_limited, api_quota_exceeded. 400 validation_failed (field-пен). 404 search_session_not_found, order_not_found, booking_not_found. 409 offer_expired, rate_expired, price_changed. 402 insufficient_credit (тек production — депозитіңізді толықтырыңыз). 502 supplier_error — әуе компаниясы немесе қонақүй жеткізушісі сәтсіз жауап берді; іздеуді қайталаңыз.
Қауіпсіз қайталау
429-ды Retry-After өткеннен кейін, ал 502/503/504-ті экспоненциалды кідіріспен қайталаңыз. 429-дан басқа ешбір 4xx-ті қайталамаңыз. Міндеттеме жасайтын шақыруларды (тапсырыстар, брондаулар, рәсімдеу, күшін жою) тек сол Idempotency-Key-мен қайталаңыз. Іздеу сессиясының мерзімі өтсе (404), жаңа іздеуді бастаңыз — ұсыныс ID-лері мен тариф кілттері сессиялар арасында жарамсыз.