สภาพแวดล้อม ขีดจำกัด และการกำหนดเวอร์ชัน

แซนด์บ็อกซ์และระบบใช้งานจริง ด้วย URL หลักเดียว

URL หลัก: https://api.dubaitrip.com/v1 แซนด์บ็อกซ์และระบบใช้งานจริงใช้ร่วมกัน คีย์ที่คุณใช้ลงนามเป็นตัวเลือกสภาพแวดล้อม คีย์ dt_sbx_ ทำงานกับสภาพแวดล้อมทดสอบของซัพพลายเออร์ของเรา — การค้นหา การคิดราคา การตรวจสอบราคา คำสั่งซื้อ การจอง การออกตั๋ว และการยกเลิก ทำงานได้ครบวงจรกับสินค้าทดสอบ โดยไม่มีตั๋วหรือวอเชอร์จริงและไม่มีการเรียกเก็บเงิน คีย์ dt_live_ ซึ่งออกให้หลังการตรวจสอบเพื่อใช้งานจริง จะเข้าถึงสินค้าจริงและชำระจากเงินฝากของคุณ

การจองในแซนด์บ็อกซ์และระบบใช้งานจริงแยกจากกันในพอร์ทัลนักพัฒนาของคุณ (ทุกการจองมีการระบุไว้) และขอบเขตสิทธิ์ ขีดจำกัด และกฎ IP จัดการแยกตามสภาพแวดล้อม

ขีดจำกัดอัตราและโควตา

แต่ละคีย์ถูกควบคุมด้วย token bucket (คำขอต่อเนื่องต่อวินาทีบวก burst) และโควตารายวัน ค่าเริ่มต้นของแซนด์บ็อกซ์: 2 คำขอ/วินาที, burst 5, 2,000 คำขอ/วัน ขีดจำกัดของระบบใช้งานจริงตกลงกันเป็นรายบัญชี เมื่อเกิน bucket จะตอบกลับ 429 api_rate_limited พร้อมเฮดเดอร์ Retry-After เมื่อโควตาหมดจะตอบกลับ 429 api_quota_exceeded จนถึงเที่ยงคืน UTC

การค้นหาที่หนักถูกออกแบบให้เป็นแบบอะซิงโครนัส: ส่ง wait=false เพื่อรับ searchId ทันทีแล้ว poll เอนด์พอยต์การค้นหา หรือ wait=true เพื่อรับผลลัพธ์ครบในการเรียกครั้งเดียว การ poll นับรวมในขีดจำกัดของคุณเหมือนคำขออื่น

ตัวควบคุมอัตราค้นหาต่อจอง

การค้นหายังถูกจำกัดตามจำนวนการจองที่คุณทำ ทุกวันในช่วงเวลาย้อนหลัง (ค่าเริ่มต้น 7 วัน) ให้โควตาการค้นหาฟรี และทุกการจองในช่วงนั้นจะเพิ่มการค้นหาอีกเท่ากับ cap — cap คือจำนวนการค้นหาต่อการจองที่ตกลงไว้สำหรับบัญชีของคุณและแสดงในพอร์ทัลนักพัฒนา การ poll การคิดราคา กฎค่าโดยสาร และการอ่านเนื้อหาไม่นับรวม นับเฉพาะการเรียกค้นหาเที่ยวบินและโรงแรมเท่านั้น

เมื่อโควตาหมด การค้นหาจะตอบกลับ 429 look_to_book_exceeded พร้อมเฮดเดอร์ Retry-After ที่ชี้ไปยังเที่ยงคืน UTC ถัดไป ซึ่งเป็นเวลาที่วันเก่าที่สุดในช่วงเวลาหลุดออกไป การจองหนึ่งครั้งจะเปิดโควตาใหม่ทันที การ์ดอัตราค้นหาต่อจองในพอร์ทัลนักพัฒนาแสดงตัวนับแบบเรียลไทม์ cap และจำนวนที่เหลือ หากการเชื่อมต่อของคุณจำเป็นต้องค้นหามากกว่าการจองอย่างมากโดยชอบธรรม ให้ขอให้เราเพิ่ม cap แทนการลองซ้ำฝ่าการปฏิเสธ

การป้องกันคำขอซ้ำ (Idempotency)

เอนด์พอยต์ที่ผูกมัดเงินหรือสินค้า — การสร้างคำสั่งซื้อหรือการจอง การออกตั๋ว การยกเลิก — ต้องมีเฮดเดอร์ Idempotency-Key (สตริงที่ไม่ซ้ำใดก็ได้ยาวไม่เกิน 128 อักขระ ใช้ UUID จะดีที่สุด) การลองซ้ำด้วยคีย์เดิมจะได้การตอบกลับเดิมแทนการสร้างรายการซ้ำ ส่วนเนื้อหาที่ต่างออกไปภายใต้คีย์ที่ใช้ซ้ำจะได้รับ 409

การกำหนดเวอร์ชัน

เวอร์ชันอยู่ในพาธ (/v1) การเปลี่ยนแปลงแบบเพิ่มเติม — ฟิลด์ใหม่ที่ไม่บังคับ ค่า enum ใหม่ เอนด์พอยต์ใหม่ — จะออกโดยไม่เปลี่ยนเวอร์ชัน ดังนั้นให้แยกวิเคราะห์อย่างระมัดระวังและละเว้นฟิลด์ที่ไม่รู้จัก การเปลี่ยนแปลงที่ไม่เข้ากันกับของเดิมจะได้เวอร์ชันหลักใหม่พร้อมช่วงเวลาย้ายระบบ คู่มือบันทึกการเปลี่ยนแปลงแสดงทุกการเปลี่ยนแปลง