ข้ามไปยังเนื้อหา
เดโมสด
บล็อก

API จองโรงแรมและตั๋วเครื่องบิน: ทริปเดียว สองการจอง

กองบรรณาธิการ Tekravel
เขียนโดยใช้ AI ช่วย

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

ยิ่งโค้ดยอมรับเรื่องนี้เร็วเท่าไร ก็ยิ่งต้องเขียนใหม่น้อยลงเท่านั้น ต่อไปนี้คือส่วนที่คู่มือการเชื่อมต่อมักข้ามไป ได้แก่ สองฝั่งต่างกันอย่างไร ฝั่งไหนควรยืนยันก่อน และทริปต้องเป็นอะไรในโมเดลข้อมูลของคุณ

สองฝั่งไม่ได้ทำงานเหมือนกัน

ทั้งสองฝั่งตอบกลับมาเป็น JSON ที่มีราคาและรหัสอ้างอิง จึงดูคล้ายกันเมื่อมองจากข้อมูลที่ส่งผ่านสาย แต่ไม่ได้คล้ายกันเลยในแง่ของสิ่งที่สัญญากับคุณหลังจากได้รหัสอ้างอิงมาแล้ว

คำถามเที่ยวบินโรงแรม
หลังจองแล้วคุณถืออะไรอยู่การจอง (PNR) ที่ยังไม่ใช่ตั๋วการยืนยันซึ่งโดยมากก็คือสิ่งที่คุณขายไปแล้ว
ราคาใช้ได้นานแค่ไหนจนกว่าค่าโดยสารจะถูกคำนวณใหม่ตอนจอง ซึ่งอาจต่างจากตอนค้นหาจนกว่าเรตจะหมดอายุ และเรตอาจเปลี่ยนระหว่างการเช็กห้องว่างกับการจอง
อะไรเป็นตัวยืนยันการออกตั๋ว ซึ่งมักมีกำหนดเวลาการยืนยันจากซัพพลายเออร์ บางครั้งทันที บางครั้งรอดำเนินการ
ยกเลิกอย่างไรVoid หากจับได้เร็ว ไม่เช่นนั้นคือคืนเงินตามกฎค่าโดยสาร ซึ่งมักมีค่าปรับยกเลิกตามนโยบายของเรตนั้นเอง หลายเรตยกเลิกฟรีจนถึงเส้นตาย
อะไรเปลี่ยนตัวเลขในนาทีสุดท้ายค่าโดยสาร ภาษี บางครั้งสกุลเงินของค่าโดยสารภาษีและค่าธรรมเนียมที่จ่ายที่ที่พัก ประเภทอาหาร และห้องที่ได้รับจริง

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

ควรจองฝั่งไหนก่อน

ไม่มีใครบอกคุณว่านี่คือการตัดสินใจเชิงออกแบบ และมันคือการตัดสินใจที่กำหนดว่าความล้มเหลวจะมีราคาเท่าไร

สมมติลูกค้าซื้อเที่ยวบินและโรงแรมสำหรับวันเดียวกัน คุณส่งการจองหนึ่งแล้วจึงส่งอีกการจอง มีสามสิ่งที่เกิดขึ้นได้ ทั้งสองสำเร็จ หรือหนึ่งล้มเหลว หรือหนึ่งล้มเหลวหลังจากอีกฝั่งสำเร็จไปแล้ว อย่างแรกคือวันที่ดี อีกสองอย่างเป็นตัวกำหนดคิวซัพพอร์ตของคุณ

ถ้าคุณออกตั๋วเครื่องบินก่อนแล้วโรงแรมปฏิเสธ คุณจะมีลูกค้าที่มีที่นั่งไปเมืองหนึ่งแต่ไม่มีห้องพัก ถูกเรียกเก็บเงินไปแล้ว และต้องคืนเงินตั๋วที่มีค่าปรับ ถ้าคุณจองโรงแรมก่อนแล้วเที่ยวบินล้มเหลว คุณถือห้องที่หลายครั้งยกเลิกได้ฟรี การแก้ไขจึงถูก ความเสี่ยงในทางกลับกันก็มีจริง เพราะเรตโรงแรมที่ยกเลิกไม่ได้คือสิ่งที่แย่กว่าที่จะถือไว้ ดังนั้นอ่านเงื่อนไขการยกเลิกของเรตก่อนปล่อยให้มันไปก่อน

นี่คือหลักคร่าวๆ ไม่ใช่กฎตายตัว และประเด็นคือคุณต้องเลือกลำดับอย่างตั้งใจ ยืนยันฝั่งที่ยกเลิกง่ายกว่าก่อนฝั่งที่ยกเลิกยากกว่า ตรวจราคาทั้งสองฝั่งก่อนที่ฝั่งใดจะถูกยืนยัน และเขียนไว้ว่าจะทำอะไรในแต่ละผลลัพธ์ทั้งสามแบบ ผู้รีวิวโค้ดไม่ค่อยถาม แต่ลูกค้ารู้เสมอ

ทริปเดียว สองการจอง

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

แยกสองสถานะออกจากกัน "ยืนยันแล้ว" ของโรงแรมกับ "ออกตั๋วแล้ว" ของเที่ยวบินไม่ใช่สถานะเดียวกัน และคอลัมน์สถานะเดียวที่รวบทั้งสองเข้าด้วยกัน ไม่ช้าก็เร็วจะแสดงว่า "จองแล้ว" บนทริปที่จองไปแค่ครึ่งเดียว

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

แพลตฟอร์มนี้อยู่ตรงไหน

พูดตรงๆ แพลตฟอร์มนี้มี API สำหรับเที่ยวบินและโรงแรม และการเข้าถึงเริ่มจากการพูดคุย ไม่ใช่คีย์ที่กดรับเอง บริการถูกเปิดใช้แยกตาม tenant ดังนั้น tenant ที่ขายโรงแรมแต่ไม่ขายทัวร์จะไม่ต้องแบกส่วนของทัวร์ ไม่มีอะไรตรงนี้สัญญาว่าจะมีคำสั่งเดียวที่จองทั้งสองฝั่งแบบอะตอมมิก และคุณไม่ควรออกแบบราวกับว่ามี ให้ปฏิบัติกับมันในฐานะสองการจองอย่างที่มันเป็น ภายใต้ทริปที่คุณเป็นเจ้าของ

ถ้าคุณอยากเห็นคำสั่งและเงื่อนไขจริงก่อนจะสร้างระบบรอบมัน เริ่มที่ หน้า API การเดินทาง และนำลำดับการจองที่คุณตั้งใจไว้มาด้วย ถ้าคุณยังชั่งใจว่าการเข้าถึงแบบฟรีให้อะไรบ้าง API จองโรงแรมฟรี อธิบายความฟรีแต่ละแบบไว้

ทำพลาดแล้วต้องจ่ายเท่าไร

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

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

กองบรรณาธิการ Tekravel

โต๊ะข่าวเทคโนโลยีท่องเที่ยว

โต๊ะข่าวเทคโนโลยีท่องเที่ยวของ Tekravel เขียนให้คนในวงการ ทั้งเจ้าของเอเจนซี ผู้รวบรวมตั๋ว และนักพัฒนาที่เชื่อมต่อระบบให้พวกเขา ทุกบทความถูกตรวจสอบกับแพลตฟอร์มที่กล่าวถึงก่อนเผยแพร่