เริ่มต้นใช้งานอย่างรวดเร็ว

1. รับข้อมูลรับรองแซนด์บ็อกซ์

ลงทะเบียนที่หน้า API การเดินทาง เมื่อยืนยันอีเมลแล้ว บัญชีพาร์ตเนอร์ของคุณจะถูกสร้างขึ้นและ ID คีย์แซนด์บ็อกซ์จะแสดงบนหน้าจอ ส่วนคีย์ลับจะส่งผ่านลิงก์เปิดดูแบบใช้ครั้งเดียวไปยังอีเมลเดียวกัน เก็บไว้ในตัวจัดการข้อมูลลับของคุณ — คีย์ลับจะแสดงเพียงครั้งเดียวเท่านั้น

คุณจะได้รับรหัสผ่านชั่วคราวสำหรับพอร์ทัลนักพัฒนาด้วย ซึ่งคุณสามารถสร้างและหมุนเวียนคีย์ ตั้งค่ารายการ IP ที่อนุญาต ติดตามการใช้งาน และขอใช้งานจริงได้

2. ลงนามทุกคำขอ

ทุกการเรียกมีเฮดเดอร์สี่ตัว: X-API-Key (ID คีย์ของคุณ), X-Timestamp (วินาทีแบบ unix), X-Nonce (อักขระสุ่ม 16–128 ตัว) และ X-Signature — ค่า HMAC-SHA256 แบบเลขฐานสิบหกตัวพิมพ์เล็กของสตริงมาตรฐาน โดยใช้คีย์ลับของคุณเป็นคีย์

สตริงมาตรฐานคือห้าบรรทัดที่เชื่อมด้วยการขึ้นบรรทัดใหม่: เมธอด HTTP เป็นตัวพิมพ์ใหญ่ พาธพร้อม query string ตรงตามที่ส่ง timestamp, nonce และค่า SHA-256 แบบเลขฐานสิบหกตัวพิมพ์เล็กของเนื้อหาดิบ (เนื้อหาว่างจะแฮชเป็น SHA-256 ของศูนย์ไบต์) timestamp ต้องต่างจากนาฬิกาของเราไม่เกิน 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_ จะเข้าถึงซัพพลายเออร์จริงและชำระจากเงินฝากของคุณ ส่วนคีย์แซนด์บ็อกซ์ยังใช้ทดสอบได้ต่อไป