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

เชื่อมต่อ API จองตั๋วเครื่องบิน: สิ่งที่เอกสารไม่ได้บอก

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

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

บทความนี้เขียนให้นักพัฒนาที่ไม่เคยเห็น PNR มาก่อน ไม่ได้พูดถึง endpoint ของซัพพลายเออร์รายใดรายหนึ่ง ชื่อเรียกเปลี่ยนไปตามผู้ให้บริการ แต่รูปร่างไม่เปลี่ยน

ลำดับการเรียกในการเชื่อมต่อ API จองตั๋วเครื่องบิน

API เที่ยวบินแทบทุกเจ้า ไม่ว่าจะตั้งชื่อเมธอดว่าอะไร ล้วนเดินผ่านสี่ขั้นเดียวกัน การขีดเส้นแบ่งระหว่างขั้นให้ถูกคืองานส่วนใหญ่

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

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

สังเกตด้วยว่าสิ่งที่การค้นหาไม่ได้ให้มาคือคำสัญญา ผลค้นหาเป็นแค่โฆษณา ขั้นเช็กราคาคือใบเสนอราคา และมีเพียงตั๋วเท่านั้นที่เป็นการขาย

ทำไมราคาที่ค้นเจอไม่ใช่ราคาที่จองได้

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

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

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

Idempotency และความหมายของ timeout ระหว่างจอง

ส่วนนี้ควรอ่านสองรอบ

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

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

สิ่งที่ได้ผล เรียงคร่าวๆ ตามนี้

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

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

แนวคิดของสายการบินที่ทำให้นักพัฒนาเว็บประหลาดใจ

ไม่มีข้อไหนยาก แต่ละข้อเคยทำให้ใครสักคนเสียเวลาไปหนึ่งสัปดาห์เพราะไม่รู้ว่ามันมีอยู่

PNR ไม่ใช่ตั๋ว

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

ชื่อแทบเปลี่ยนไม่ได้

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

ประเภทผู้โดยสารมีราคา ไม่ใช่ของประดับ

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

เวลาเป็นเวลาท้องถิ่น และเซกเมนต์ไม่ใช่เลก

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

หลายอย่างเกิดขึ้นหลังการขาย

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

Void ไม่ใช่การคืนเงิน

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

ราคาของความผิดพลาด

ความล้มเหลวในการเชื่อมต่อเที่ยวบินแพงในแบบเฉพาะตัว คือมันตกไปอยู่ที่คน ไม่ใช่ที่ล็อก การจองซ้ำกลายเป็นโทรศัพท์หาสายการบินและอาจเป็นใบแจ้งหนี้ต่อบัญชีเอเจนซี่ ลูกค้าที่ถูกตัดเงินแต่ไม่มีตั๋วกลายเป็นการคืนเงิน การร้องเรียน และความเสี่ยงเรื่อง chargeback ตั๋วที่ออกโดยไม่มีการชำระเงินสำเร็จกลายเป็นหนี้ต่อสายการบินที่ต้องมีคนชดใช้ การเปลี่ยนตารางบินที่ไม่มีใครจัดการกลายเป็นผู้โดยสารที่สนามบินสำหรับเที่ยวบินที่ออกไปก่อนแล้ว

ไม่มีสิ่งใดปรากฏในการทดสอบเส้นทางที่ราบรื่น ให้เขียนเส้นทางที่ไม่ราบรื่นก่อน ได้แก่ timeout ระหว่างจอง ราคาที่ขึ้น ตั๋วที่ล้มเหลวหลัง PNR เกิดขึ้น และการ void หลังชำระเงินสำเร็จ ถ้าจัดการสิ่งเหล่านี้ได้ เส้นทางที่ราบรื่นคือส่วนที่ง่าย

การทดสอบกับ API เที่ยวบิน

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

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

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

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

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