빠른 시작

1. 샌드박스 인증 정보 받기

여행 API 페이지에서 가입하세요. 이메일이 인증되면 파트너 계정이 생성되고 화면에 샌드박스 키 ID가 표시됩니다. 시크릿은 같은 주소로 발송되는 일회용 확인 링크로 전달됩니다. 시크릿은 단 한 번만 표시되므로 시크릿 관리 도구에 보관하세요.

개발자 포털 임시 비밀번호도 함께 받게 됩니다. 포털에서 키를 생성·교체하고, IP 허용 목록을 설정하고, 사용량을 확인하고, 프로덕션을 요청할 수 있습니다.

2. 모든 요청에 서명하기

모든 호출에는 네 개의 헤더가 포함됩니다: X-API-Key(키 ID), X-Timestamp(Unix 초), X-Nonce(16–128자의 임의 문자열), X-Signature — 시크릿을 키로 사용한 정규 문자열의 HMAC-SHA256 값을 소문자 16진수로 표현한 것.

정규 문자열은 줄바꿈으로 연결된 다섯 줄입니다: 대문자 HTTP 메서드, 전송한 그대로의 경로와 쿼리 문자열, 타임스탬프, nonce, 원본 본문의 SHA-256 값(소문자 16진수, 본문이 비어 있으면 0바이트의 SHA-256). 타임스탬프는 당사 서버 시각과 300초 이내여야 하며, nonce는 10분 안에 한 번만 사용할 수 있습니다.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. 첫 호출 보내기

샌드박스에서 항공편을 검색해 보세요. 샌드박스는 공급사의 테스트 환경에 연결되어 있어 검색하면 테스트 재고와 가격이 반환되고, 샌드박스에서 한 예약은 테스트 예약입니다 — 실제 항공권도, 요금 청구도 없습니다. 모든 레퍼런스 페이지에는 cURL, Node.js, Python, PHP로 된 완전한 샘플이 있습니다 — 복사해서 키 ID와 시크릿을 채우고 실행하세요.

curl -X POST "https://api.dubaitrip.com/v1/flights/search" \
  -H "X-API-Key: $KEY_ID" -H "X-Timestamp: $TS" -H "X-Nonce: $NONCE" -H "X-Signature: $SIG" \
  -H "Content-Type: application/json" \
  -d '{"slices":[{"origin":"DXB","destination":"LHR","departureDate":"2026-11-15"}],"passengers":{"adults":1},"wait":true}'

4. 예약 흐름 완료하기

항공: 검색 → 선택한 오퍼 가격 확인 → 승객과 연락처로 주문 생성 → 발권 → (선택) 환불 견적 및 환불 요청. 호텔: 검색 → 숙소의 객실 조회 → 요금 확인 → 예약 생성 → (선택) 취소 견적 및 취소.

오퍼 ID와 요금 키는 불투명하며 유효 기간이 짧습니다. 확정하기 직전에 반드시 가격이나 요금을 확인하세요. 가격이 바뀌었다면 새 금액과 함께 409 price_changed를 받게 되며, 진행 여부는 직접 결정합니다.

5. 프로덕션 요청하기

연동이 샌드박스에서 처음부터 끝까지 흐름을 완료하면 개발자 포털을 열고 프로덕션을 요청하세요. 당사가 샌드박스 활동(검색, 주문, 예약, 취소)과 연동 세부 정보를 검토한 뒤 계정을 전환합니다. 프로덕션 키 쌍은 같은 일회용 확인 링크를 통해 이메일로 전달됩니다. 기본 URL은 같습니다 — dt_live_ 키로 서명된 요청은 실제 공급사에 연결되어 예치금으로 정산되며, 샌드박스 키는 테스트용으로 계속 작동합니다.