오류

모든 실패는 안정적인 기계 판독용 코드가 포함된 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(키에 해당 스코프가 없음), 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(프로덕션 전용 — 예치금을 충전하세요). 502 supplier_error — 항공사 또는 호텔 공급사에서 오류가 발생했으니 검색을 다시 시도하세요.

안전하게 재시도하기

429는 Retry-After 이후에, 502/503/504는 지수 백오프로 재시도하세요. 429 이외의 4xx는 절대 재시도하지 마세요. 확정 작업(주문, 예약, 발권, 취소)은 같은 Idempotency-Key로만 재시도하세요. 검색 세션이 만료되면(404) 새로 검색하세요 — 오퍼 ID와 요금 키는 세션 간에 유효하지 않습니다.