CreateBooking Ready

หากต้องการทํางานย่อย "พร้อม" ของงานหลัก CreateBooking ให้เสร็จสมบูรณ์ คุณต้องสร้างและส่งเมธอด CreateBooking ให้สําเร็จ ระบบจะเรียกใช้เมธอดนี้เมื่อผู้ใช้พยายามสร้างการจอง หากสร้างการจองได้สำเร็จ การตอบกลับจะมี booking_id ที่ไม่ซ้ำกันเพื่อใช้อ้างอิงการจองสําหรับคําขอหรือการอัปเดตในอนาคต

ข้อกำหนดของงาน CreateBooking

  • คําขอ CreateBooking 10 รายการใน Sandbox ที่มีอัตราความสําเร็จ 90% ขึ้นไป
  • คําขอ CreateBooking 3 รายการใน Production ที่มีอัตราความสําเร็จ 90% ขึ้นไป

ข้อมูลเบื้องต้นเกี่ยวกับ CreateBooking

เมื่อผู้ใช้เริ่มการจอง ระบบจะส่งคําขอ CreateBooking ไปยังเซิร์ฟเวอร์การจองของพาร์ทเนอร์ การตอบกลับคําขอจะระบุว่าการจองสําเร็จหรือล้มเหลว หากการจองล้มเหลว การตอบกลับต้องมีข้อผิดพลาดทางตรรกะทางธุรกิจที่ทําให้เกิดความล้มเหลว เช่น ช่องว่างไม่ว่างแล้วหรือผู้ใช้คนเดียวกันจองช่องว่างดังกล่าวไปแล้ว

เมื่อผู้ใช้สร้างการจอง Google จะส่งชื่อ นามสกุล หมายเลขโทรศัพท์ และอีเมลของผู้ใช้ให้คุณ ดูข้อมูลเพิ่มเติมได้ที่ นโยบายการจับคู่และการสร้างบัญชี

การไม่เปลี่ยนแปลงผลลัพธ์

การสื่อสารผ่านเครือข่ายอาจไม่เสถียรเสมอไป และ Google อาจลองส่งคําขอ HTTP อีกครั้งหากไม่ได้รับการตอบกลับ ด้วยเหตุนี้ เมธอดทั้งหมดที่เปลี่ยนแปลงสถานะต้องไม่เปลี่ยนแปลงผลลัพธ์ ดังนี้

  • CreateBooking
  • UpdateBooking

ระบบจะรวมโทเค็นการไม่เปลี่ยนแปลงผลลัพธ์ไว้ในข้อความคําขอทุกรายการ ยกเว้น UpdateBooking เพื่อระบุคําขอที่ไม่ซ้ำกัน ซึ่งจะช่วยให้คุณแยกแยะระหว่างการเรียก REST ที่ลองอีกครั้งโดยมีจุดประสงค์เพื่อสร้างคําขอเดียวกับคําขอ 2 รายการที่แยกกัน รหัสรายการการจองที่เกี่ยวข้องของ UpdateBooking ช่วยระบุรายการการจองที่ไม่ซ้ำกันได้ ดังนั้นระบบจึงไม่รวมโทเค็นการไม่เปลี่ยนแปลงผลลัพธ์ไว้ในคําขอ

ตัวอย่างวิธีที่เซิร์ฟเวอร์การจองจัดการการไม่เปลี่ยนแปลงผลลัพธ์มีดังนี้

  • การตอบกลับ HTTP CreateBooking ที่สําเร็จจะรวมการจองที่สร้างขึ้น ในบางกรณี ระบบจะประมวลผลการชําระเงินเป็นส่วนหนึ่งของขั้นตอนการจอง หากได้รับ CreateBookingRequest เดียวกันเป็นครั้งที่ 2 โดยมี idempotency_token เดียวกัน ระบบจะต้องแสดง CreateBookingResponse เดียวกัน ระบบจะไม่สร้างการจองครั้งที่ 2 และจะเรียกเก็บเงินจากผู้ใช้เพียงครั้งเดียว (หากมี)

ข้อกําหนดการไม่เปลี่ยนแปลงผลลัพธ์มีผลกับเมธอดทั้งหมดที่เปลี่ยนแปลงสถานะ