Ruka hadi maudhui
Demo ya moja kwa moja

Makosa

Kila kushindwa ni hati ya tatizo ya RFC 7807 yenye msimbo thabiti unaosomeka na mashine.

  1. Maelezo ya tatizo
  2. Misimbo utakayokutana nayo
  3. Kujaribu tena kwa usalama

Maelezo ya tatizo

Majibu yasiyo ya 2xx hubeba application/problem+json yenye status, title, detail, code thabiti (snake_case), field ya hiari inayotaja sifa ya ombi yenye tatizo, na traceId ya kutaja unapowasiliana na huduma kwa wateja.

Mfano
{
  "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…"
}

Misimbo utakayokutana nayo

401 api_key_invalid, api_signature_invalid, api_timestamp_skew, api_nonce_reused, api_token_invalid — matatizo ya uthibitishaji. 403 api_scope_missing (ufunguo wako hauna wigo huo), api_ip_not_allowed, api_partner_suspended. 429 api_rate_limited, api_quota_exceeded. 400 validation_failed (pamoja na field). 404 search_session_not_found, order_not_found, booking_not_found. 409 offer_expired, rate_expired, price_changed. 402 insufficient_credit (uzalishaji pekee — ongeza fedha kwenye amana yako). 502 supplier_error — msambazaji wa shirika la ndege au hoteli ameshindwa; rudia utafutaji.

Kujaribu tena kwa usalama

Jaribu tena 429 baada ya Retry-After, na 502/503/504 kwa kusubiri kunakoongezeka kwa kasi (exponential backoff). Usijaribu tena kamwe 4xx nyingine isipokuwa 429. Jaribu tena hatua za kufunga (oda, uhifadhi, kutoa, kughairi) kwa Idempotency-Key ile ile pekee. Kipindi cha utafutaji kikiisha (404), anza utafutaji mpya — vitambulisho vya ofa na funguo za bei havifanyi kazi kati ya vipindi.