เปรียบเทียบ API ท่องเที่ยว: ให้คะแนนที่แกน ไม่ใช่ที่ผู้ขาย

คุณเปิดสไลด์ของผู้ขายสามรายไว้ในสามแท็บ ทุกชุดมีสไลด์รายชื่อสายการบินยาวเหยียด สไลด์จำนวนโรงแรม มี sandbox มี REST และ JSON และมีอีเมลซัพพอร์ต คุณทำสเปรดชีต ติ๊กถูกทุกช่อง แล้วสเปรดชีตก็จบลงที่เสมอกัน นี่คือตอนจบตามปกติของการเปรียบเทียบ API ท่องเที่ยวแบบเช็กลิสต์ฟีเจอร์ และเป็นตอนจบที่ผิด เพราะความต่างที่จะตัดสินปีหน้าของคุณจะโผล่มาหลัง go-live เท่านั้น ทั้งการจองที่สำเร็จฝั่งซัพพลายเออร์แต่ timeout ฝั่งคุณ การคืนเงินที่ไม่มีใครดำเนินการได้ และสายการบินที่อยู่ในรายชื่อแต่ออกตั๋วผ่านเส้นทางนี้ไม่ได้
บทความนี้เขียนให้นักพัฒนาหรือหัวหน้าทีมเทคนิคที่ต้องตัดสินใจเรื่องนี้และต้องปกป้องการตัดสินใจนั้นในภายหลัง เราไม่จัดอันดับผู้ขาย แต่ให้แกนสำหรับเปรียบเทียบ แผนช่วงทดลองที่ใช้เวลาไปกับความล้มเหลว และชุดคำถามสั้นๆ ที่บอกได้เร็วว่าคุณกำลังคุยกับซัพพลายเออร์ตัวจริง หรือกับคนที่ขายต่อซัพพลายเออร์ของคนอื่น
ทำไมเช็กลิสต์ฟีเจอร์ถึงจบที่เสมอทุกครั้ง
เช็กลิสต์ถามว่าความสามารถนั้นมีอยู่หรือไม่ API ท่องเที่ยวเกือบทุกรายตอบว่ามีได้เกือบทุกแถว เพราะแถวเหล่านั้นเขียนในระดับหน้าการตลาด คือ ค้นหา ราคา จอง ยกเลิก ออกตั๋ว webhook และ sandbox คำถามที่แยกพวกเขาออกจากกันไม่ใช่ว่ามี cancel หรือไม่ แต่คือเกิดอะไรขึ้นเมื่อคุณเรียกมันกับการจองที่ออกตั๋วแล้วสิบสองชั่วโมงก่อนเดินทาง กับค่าโดยสารที่มีค่าปรับ ผ่านเส้นทางที่เนื้อหามาจากบุคคลที่สาม เช็กลิสต์ไม่มีคอลัมน์สำหรับเรื่องนี้
ยังมีปัญหาข้อที่สอง คนกรอกเช็กลิสต์มักเป็นผู้ขายเอง คุณกำลังให้คะแนนคำบรรยายตัวเองของพวกเขา
เปรียบเทียบ API ท่องเที่ยวด้วยแกน ไม่ใช่ด้วยรายชื่อผู้ขาย
เปลี่ยนตารางผู้ขายคูณฟีเจอร์เป็นแกนที่คุณให้คะแนนเอง จากหลักฐานที่เก็บได้ในช่วงทดลอง ตารางด้านล่างคือแบบที่เราจะใช้ คุณอาจให้น้ำหนักแต่ละแถวต่างออกไป ธุรกิจที่ขายแต่โรงแรมย่อมสนใจเรื่องออกตั๋วน้อยกว่า และควรถกเถียงกับมันก่อนนำไปใช้
| แกน | เช็กลิสต์ถามอะไร | สิ่งที่ต้องหาคำตอบจริงๆ | คำตอบที่อ่อนฟังดูอย่างไร |
|---|---|---|---|
| ความครอบคลุม | มีสายการบินและโรงแรมกี่แห่ง | กี่แห่งที่ค้นหา จอง และออกตั๋วหรือยืนยันได้จริงผ่าน API นี้ ในตลาดของคุณ | ตัวเลขใหญ่ตัวเดียวโดยไม่แยกย่อย |
| ความลึก | มี endpoint ยกเลิกหรือไม่ | งานหลังการจองใดบ้างที่อัตโนมัติตามแหล่งเนื้อหา ทั้ง void คืนเงิน reissue แก้ชื่อ และบริการเสริม | “ทีมปฏิบัติการของเราดูแลให้” |
| ความถูกต้องของราคา | ราคาเป็นเรียลไทม์หรือไม่ | ราคาตอนจองต่างจากราคาตอนค้นหาบ่อยแค่ไหน และ API แจ้งคุณอย่างไร | “ราคาเป็น live เสมอ” |
| ความหมายของข้อผิดพลาด | มีเอกสารข้อผิดพลาดหรือไม่ | ข้อผิดพลาดบอกได้ไหมว่าการจองอยู่ในสถานะใด ไม่ใช่แค่บอกว่ามีอะไรพัง | โค้ดข้อผิดพลาดกลางๆ ตัวเดียวสำหรับทุกกรณี |
| Idempotency | — | การเรียกจองซ้ำสร้างการจองที่สองได้หรือไม่ | เงียบ แล้วตามด้วย “เราไม่เคยเจอแบบนั้น” |
| Supplier of record | — | สัญญาของใคร เลข IATA ของใคร ตั๋ววิ่งผ่าน BSP ของใคร | “เราทำงานกับ GDS รายใหญ่ทุกราย” |
| การเข้าถึงและการซัพพอร์ต | มี sandbox หรือไม่ | ใครตอบเมื่อ PNR จริงค้าง และตอบเร็วแค่ไหน | มีแค่ฟอร์มเปิดทิกเก็ต ไม่มีชื่อผู้ติดต่อ |
สองแถวในตารางไม่มีคำถามในเช็กลิสต์เลย นั่นไม่ใช่เรื่องบังเอิญ เพราะเป็นแถวที่แพงที่สุดเวลาเกิดปัญหา และเป็นแถวที่สไลด์ของผู้ขายมีแนวโน้มจะไม่พูดถึงเองมากที่สุด
ความครอบคลุมไม่ใช่ความลึก
รายชื่อสายการบินคือสไลด์ที่ชวนเข้าใจผิดที่สุดในทุกชุด รายชื่อหลายร้อยสายการบินอาจหมายถึงหลายสิ่ง และมีเพียงสิ่งเดียวที่คุณต้องการ
บางสายการบินมาผ่าน GDS และจองพร้อมออกตั๋วได้ครบตั้งแต่ต้นจนจบ บางสายมาผ่านการเชื่อมต่อ NDC ซึ่งการค้นหาอาจทำงานดี แต่บริการหลังการจอง เช่น เปลี่ยนแปลง คืนเงินบางส่วน หรือเพิ่มกระเป๋า อาจยังต้องทำมือสำหรับสายการบินนั้น บางสายเป็นสายการบินต้นทุนต่ำที่เนื้อหารวบรวมมาจากผู้ขายต่ออีกทอด คุณแสดงผลได้ บางครั้งจองได้ แล้วตั๋วก็มาถึงผ่านเส้นทางที่คุณควบคุมไม่ได้ ในเวลาที่คุณสัญญากับลูกค้าไม่ได้ และบางสายอยู่ในรายชื่อเพียงเพราะเคยมีค่าโดยสารโผล่ในผลการค้นหาสักครั้ง
สายการบินที่แสดงได้แต่ออกตั๋วไม่ได้ไม่ใช่ความครอบคลุม สำหรับสินค้าค้าปลีกมันแย่กว่าการไม่มีเสียอีก เพราะลูกค้าเลือก จ่ายเงิน แล้วก็รอ
โรงแรมมีรูปแบบเดียวกันแค่ใช้คำต่างกัน จำนวนที่พักรวมทั้งที่ผู้ขายแมปแล้วและยังไม่ได้แมป ราคาคงที่ที่แคชไว้เมื่อสัปดาห์ก่อนวางคู่กับห้องว่างแบบ live ห้อง allotment ที่มี release period วางคู่กับสต็อก free-sale ให้ขอตัวเลขที่จองแบบ live ได้จริงในเมืองที่คุณขาย และถามว่าพวกเขารวมรายการซ้ำข้ามซัพพลายเออร์ของตัวเองอย่างไร โรงแรมเดียวกันโผล่สามครั้งในสามราคาคือทิกเก็ตซัพพอร์ตที่รอวันเกิด
การทดสอบเชิงปฏิบัติทำแบบแคบๆ เขียนเส้นทางบินยี่สิบเส้นทางและเมืองโรงแรมยี่สิบเมืองที่เป็นยอดขายส่วนใหญ่ของคุณ แล้วขอให้ผู้ขายแสดงให้ดูว่ารายการเหล่านั้นทำงานครบวงจรใน sandbox ได้จริง ค้นหา ราคา จอง ออกตั๋วหรือยืนยัน และยกเลิก ผู้ขายที่มีความลึกจะทำให้ดูโดยไม่อิดออด ผู้ขายที่มีแค่สไลด์จะเริ่มพูดถึงสไลด์
ช่วงทดลองควรทดสอบอะไร: เส้นทางข้อผิดพลาด ไม่ใช่เส้นทางราบรื่น
ทุก sandbox จองตั๋วชั้นประหยัดเที่ยวเดียวบนเส้นทางที่เงียบได้สำเร็จ sandbox ถูกสร้างมาเพื่อโชว์สิ่งนั้น แต่ทราฟฟิกจริงของคุณจะใช้ชีวิตส่วนสำคัญอยู่ในเส้นทางอื่น และช่วงทดลองคือจังหวะเดียวที่ดูมันได้ในราคาถูก
ใช้ช่วงทดลองไล่ตามรายการนี้ และจดสิ่งที่ API ตอบกลับไว้ข้างๆ สิ่งที่เป็นจริงหลังจากนั้น
- ราคาเปลี่ยนระหว่างค้นหากับจอง คำสั่งจองล้มเหลว สำเร็จในราคาใหม่ หรือส่งคำตอบเฉพาะที่ขอให้คุณยืนยัน UI ของคุณแยกแยะได้ไหมโดยไม่ต้องแยกวิเคราะห์ข้อความ
- ข้อเสนอหมดอายุ ค้นหา รอนานกว่าอายุข้อเสนอของผู้ขาย แล้วจอง การหมดอายุเป็นข้อผิดพลาดเฉพาะ หรือเป็นข้อผิดพลาดเดียวกับ “ซัพพลายเออร์ล่ม”
- ที่นั่งหมดตอนจอง สต็อกหายไประหว่างขั้นราคากับขั้นจอง การจองอยู่ในสถานะใด และการกันวงเงินชำระเงินถูกปล่อยคืนหรือไม่
- ส่งซ้ำหลัง timeout ส่งคำขอจอง ตัดการเชื่อมต่อก่อนได้คำตอบ แล้วส่งอีกครั้ง ตอนนี้คุณมี PNR หนึ่งหรือสองรายการ การทดสอบข้อนี้ข้อเดียวบอกเรื่องผู้ขายได้มากกว่าส่วนที่เหลือของช่วงทดลองรวมกัน
- สร้างการจองได้ แต่ออกตั๋วล้มเหลว API รายงาน PNR ที่มีอยู่แต่ยังไม่ออกตั๋วได้ไหม และบอกกำหนดเวลาออกตั๋วหรือไม่
- ล้มเหลวบางส่วน คำขอโรงแรมหลายห้องที่ห้องหนึ่งยืนยันแต่อีกห้องไม่ยืนยัน ไป-กลับที่ขาไปและขากลับมาจากคนละแหล่ง
- ยกเลิกนอกช่วงฟรี ค่าปรับถูกแจ้งก่อนคุณยืนยัน หรือไปเจอในใบแจ้งหนี้
- ซัพพลายเออร์ล่ม ถามผู้ขายว่าจำลองอย่างไร ถ้าทำไม่ได้ ให้ถามว่าลูกค้าของพวกเขารู้พฤติกรรมของระบบได้อย่างไร
ในแต่ละกรณีคุณให้คะแนนสองเรื่อง หนึ่ง API บอกความจริงเรื่องสถานะการจองหรือไม่ สอง โค้ดของคุณลงมือตามความจริงนั้นได้โดยไม่ต้องมีคนอ่านข้อความอิสระหรือไม่ API ที่ล้มเหลวอย่างชัดเจนอยู่ด้วยง่ายกว่า API ที่สำเร็จแบบกำกวม
เราเขียนเรื่องฝั่งตั๋วเครื่องบินไว้ละเอียดกว่านี้ในสิ่งที่เอกสาร API จองตั๋วเครื่องบินไม่ได้บอก และเรื่องการออกแบบไคลเอนต์สำหรับซัพพลายเออร์โรงแรมที่ตอบช้าในบทความเรื่องห้องว่างโรงแรม ทั้งสองบทความเป็นคู่หูที่ดีของแผนช่วงทดลอง
คำถามที่เปิดโปง aggregator ที่บางเกินไป
aggregator ไม่ได้ผิดอะไร เนื้อหาท่องเที่ยวส่วนใหญ่ไปถึงผู้ขายส่วนใหญ่ผ่าน aggregator ความเสี่ยงอยู่ที่รายที่บาง คือชั้นที่ขายต่อ API ของอีกชั้นหนึ่ง บวกมาร์จิน และไม่ได้เป็นเจ้าของทั้งสัญญากับซัพพลายเออร์และโต๊ะปฏิบัติการ เมื่อมีอะไรพัง คำตอบต้องเดินทางย้อนขึ้นไปสองบริษัทแล้วกลับมา
ห้าคำถามนี้ดึงเรื่องนี้ออกมาได้เร็ว
- ใครคือ supplier of record ของการจองนี้ การจองนี้อยู่บนสัญญาของใครกับสายการบินหรือโรงแรม
- ตั๋ววิ่งผ่านเลข IATA และ BSP ของใคร ถ้าคำตอบคือ “ของพาร์ตเนอร์” ให้ถามว่าใครเป็นคนรับ ADM เมื่อกฎค่าโดยสารถูกละเมิด
- เมื่อผมเรียก cancel ฝั่งคุณเกิดอะไรขึ้น เป็นการเรียกอัตโนมัติไปยังซัพพลายเออร์ หรือเป็นคิวที่มีคนมาหยิบไปทำ
- ผมเห็นข้อผิดพลาดจากต้นทางได้ไหม ชั้นที่บางมักบีบทุกความล้มเหลวให้เหลือโค้ดเดียว เพราะไม่ได้เข้าใจข้อผิดพลาดที่ตัวเองได้รับอย่างแท้จริง
- ถ้าการจองจริงค้าง ผมโทรหาใคร แล้วเขาโทรหาใครต่อ นับจำนวนทอด
ไม่มีคำตอบข้อไหนที่ตัดสิทธิ์ได้ด้วยตัวเอง การใช้เลข IATA ของพาร์ตเนอร์อาจไม่มีปัญหาถ้าสัญญาเขียนชัดว่าใครรับ debit memo สิ่งสำคัญคือผู้ขายตอบได้แม่นยำและรวดเร็ว คำตอบคลุมเครือตรงนี้คือคำตอบที่คุณจะได้รับอีกครั้งในอนาคต บน production ในชั่วโมงที่แย่กว่า
ถ้าเลือกผิด คุณต้องจ่ายอะไร
การเชื่อมต่อคือส่วนที่ถูก ส่วนที่แพงมาทีหลังและไม่อยู่ในประมาณการใดๆ
บั๊กจองซ้ำหมายถึงลูกค้าถูกตัดเงินสองครั้ง และ PNR ที่คุณต้องตามหาและยกเลิกด้วยมือ ซึ่งอาจเลยช่วง void ฟรีไปแล้ว การจองที่สำเร็จที่ต้นทางขณะที่ฝั่งคุณบันทึกว่าล้มเหลวหมายถึงที่นั่งถูกกันไว้ แล้วถูกยกเลิกอัตโนมัติ และลูกค้าที่เชื่อว่าตัวเองจองแล้ว สายการบินที่คุณแสดงแต่ออกตั๋วไม่ได้หมายถึงการคืนเงิน คำขอโทษ และลูกค้าที่ไม่กลับมา ADM จากกฎค่าโดยสารที่เส้นทางของผู้ขายละเมิดจะตกอยู่กับเจ้าของตั๋ว รู้ไว้ล่วงหน้าว่านั่นคือคุณหรือไม่
แล้วยังมีต้นทุนการย้าย ความแปลกของผู้ขายทุกอย่างที่คุณซึมซับไว้ ทั้งรหัสสถานะที่มีสองความหมาย หรือฟิลด์ที่บางทีเป็นสตริง จะไปจบอยู่ในโมเดลข้อมูลของคุณ สองปีผ่านไป การเลือก API ไม่ใช่การเชื่อมต่อที่เปลี่ยนได้ในหนึ่งสปรินต์อีกต่อไป แต่กลายเป็นรูปร่างของตารางการจองของคุณ นั่นคือเหตุผลจริงที่ต้องเปรียบเทียบให้รอบคอบตั้งแต่ตอนนี้
API ของเราอยู่ตรงไหนในกรอบนี้
เราให้บริการ API ตั๋วเครื่องบินและโรงแรม การเข้าถึงเริ่มจากการพูดคุย ไม่ใช่คีย์แบบบริการตัวเอง ซึ่งนักพัฒนาบางคนมองว่าช้า เหตุผลคือการพูดคุยนั้นเองที่คำถามข้างต้นถูกถามจากทั้งสองฝั่ง ทั้งคุณต้องการเส้นทางและเมืองใด เนื้อหาใดที่คุณออกตั๋วหรือยืนยันได้จริง และใครดูแลอะไรหลังการจอง ถ้าคุณกำลังเปรียบเทียบอยู่ ให้นำรายการนี้มาด้วย การพูดคุยเริ่มต้นที่หน้า API ท่องเที่ยว
ไม่ว่าจะเลือกอะไร ให้เลือกจากบันทึกช่วงทดลอง ไม่ใช่จากสไลด์ สไลด์บอกว่าผู้ขายอยากเป็นอะไร เส้นทางข้อผิดพลาดบอกว่าเขาเป็นอะไรจริงๆ