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

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

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

คุณเปิดสไลด์ของผู้ขายสามรายไว้ในสามแท็บ ทุกชุดมีสไลด์รายชื่อสายการบินยาวเหยียด สไลด์จำนวนโรงแรม มี 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 ของอีกชั้นหนึ่ง บวกมาร์จิน และไม่ได้เป็นเจ้าของทั้งสัญญากับซัพพลายเออร์และโต๊ะปฏิบัติการ เมื่อมีอะไรพัง คำตอบต้องเดินทางย้อนขึ้นไปสองบริษัทแล้วกลับมา

ห้าคำถามนี้ดึงเรื่องนี้ออกมาได้เร็ว

  1. ใครคือ supplier of record ของการจองนี้ การจองนี้อยู่บนสัญญาของใครกับสายการบินหรือโรงแรม
  2. ตั๋ววิ่งผ่านเลข IATA และ BSP ของใคร ถ้าคำตอบคือ “ของพาร์ตเนอร์” ให้ถามว่าใครเป็นคนรับ ADM เมื่อกฎค่าโดยสารถูกละเมิด
  3. เมื่อผมเรียก cancel ฝั่งคุณเกิดอะไรขึ้น เป็นการเรียกอัตโนมัติไปยังซัพพลายเออร์ หรือเป็นคิวที่มีคนมาหยิบไปทำ
  4. ผมเห็นข้อผิดพลาดจากต้นทางได้ไหม ชั้นที่บางมักบีบทุกความล้มเหลวให้เหลือโค้ดเดียว เพราะไม่ได้เข้าใจข้อผิดพลาดที่ตัวเองได้รับอย่างแท้จริง
  5. ถ้าการจองจริงค้าง ผมโทรหาใคร แล้วเขาโทรหาใครต่อ นับจำนวนทอด

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

ถ้าเลือกผิด คุณต้องจ่ายอะไร

การเชื่อมต่อคือส่วนที่ถูก ส่วนที่แพงมาทีหลังและไม่อยู่ในประมาณการใดๆ

บั๊กจองซ้ำหมายถึงลูกค้าถูกตัดเงินสองครั้ง และ PNR ที่คุณต้องตามหาและยกเลิกด้วยมือ ซึ่งอาจเลยช่วง void ฟรีไปแล้ว การจองที่สำเร็จที่ต้นทางขณะที่ฝั่งคุณบันทึกว่าล้มเหลวหมายถึงที่นั่งถูกกันไว้ แล้วถูกยกเลิกอัตโนมัติ และลูกค้าที่เชื่อว่าตัวเองจองแล้ว สายการบินที่คุณแสดงแต่ออกตั๋วไม่ได้หมายถึงการคืนเงิน คำขอโทษ และลูกค้าที่ไม่กลับมา ADM จากกฎค่าโดยสารที่เส้นทางของผู้ขายละเมิดจะตกอยู่กับเจ้าของตั๋ว รู้ไว้ล่วงหน้าว่านั่นคือคุณหรือไม่

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

API ของเราอยู่ตรงไหนในกรอบนี้

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

ไม่ว่าจะเลือกอะไร ให้เลือกจากบันทึกช่วงทดลอง ไม่ใช่จากสไลด์ สไลด์บอกว่าผู้ขายอยากเป็นอะไร เส้นทางข้อผิดพลาดบอกว่าเขาเป็นอะไรจริงๆ

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

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

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