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

ก่อนจ้างบริษัทเชื่อมต่อ API ในดูไบ

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

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

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

บทความนี้เขียนให้เจ้าของที่จะเซ็นขอบเขตงาน ไม่ใช่นักพัฒนาที่จะอ่านมัน

บริษัทเชื่อมต่อ API ในดูไบส่งมอบอะไรได้ และอะไรที่ทำไม่ได้

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

สิ่งที่ส่งมอบให้คุณไม่ได้คือทุกอย่างที่อยู่อีกฝั่งของโค้ด ก่อนเขียนบรรทัดแรก เอเจนซี่ต้องมี

  • บัญชีซัพพลายเออร์ ในชื่อเอเจนซี่เอง พร้อมสิทธิ์ API ที่ผูกกับบัญชีนั้น
  • สิทธิ์ออกตั๋ว จะเป็นการรับรองของตัวเอง หรือคอนโซลิเดเตอร์ที่ออกตั๋วในนามเอเจนซี่ก็ได้
  • ข้อตกลงเรื่องเงิน กับซัพพลายเออร์รายนั้น เช่น เงินมัดจำ วงเงินเครดิต หรือการส่งต่อการชำระด้วยบัตร
  • คนที่ทำ งานหลังออกตั๋ว (void คืนเงิน ออกตั๋วใหม่ เปลี่ยนตารางบิน) ผ่าน API หรือถ้าทำไม่ได้ก็ทำด้วยมือ

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

บรีฟ: เจ็ดบรรทัดสำหรับขอบเขตงาน

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

  1. บัญชีซัพพลายเออร์และคีย์ API อยู่ในชื่อใคร ชื่อเอเจนซี่ คีย์คือข้อมูลยืนยันตัวตน เก็บไว้ในตัวจัดการรหัสผ่านของคุณ ผู้รับเชื่อมต่อได้สิทธิ์เข้าถึง ไม่ใช่ความเป็นเจ้าของ
  2. ใครโฮสต์เว็บ และใครถือโดเมน โดเมนจดในชื่อเอเจนซี่ บัญชีโฮสติ้งเป็นของเอเจนซี่ หรือสัญญาระบุชัดว่าจะโอนอย่างไร
  3. งานใดบ้างอยู่ในขอบเขต เขียนเป็นชื่อทีละข้อ ค้นหา ราคา จอง ออกตั๋ว ยกเลิก คืนเงิน เปลี่ยนแปลง อะไรที่ไม่อยู่ในรายการจะยังเป็นอีเมลถึงเคาน์เตอร์ซัพพลายเออร์ไปตลอดอายุของเว็บ การคืนเงินและการเปลี่ยนแปลงมักหายไปบ่อยที่สุด เพราะเดโมไม่เคยแสดงให้ดู
  4. ใครดูแลเมื่อซัพพลายเออร์เปลี่ยน API ซัพพลายเออร์เลิกใช้เวอร์ชันและเปลี่ยนชื่อฟิลด์อยู่เสมอ งานราคาเหมาที่ไม่มีข้อดูแลรักษาจะจบลงในวันที่เวอร์ชันแรกเปลี่ยน
  5. การส่งมอบหมายถึงอะไร ซอร์สโค้ดในรีโพสิทอรีที่เอเจนซี่เป็นเจ้าของ ข้อมูลยืนยันตัวตนทั้งหมด และเอกสารที่ทำให้นักพัฒนาคนอื่นรับงานต่อได้ "เดี๋ยวส่งไฟล์ zip ให้" ไม่ใช่การส่งมอบ
  6. พิสูจน์การเปิดใช้งานอย่างไร จองทดสอบตั้งแต่ค้นหาจนออกตั๋วในสภาพแวดล้อมทดสอบของซัพพลายเออร์ รวมถึงการยกเลิก ก่อนที่ใครจะตัดบัตรของลูกค้าจริง
  7. ข้อมูลลูกค้าจะเป็นอย่างไร ชื่อผู้โดยสาร ข้อมูลหนังสือเดินทาง และเลขอ้างอิงการชำระเงิน เก็บที่ไหน ใครอ่านได้ และลบอย่างไร

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

สามทางในการนำสินค้าของซัพพลายเออร์ขึ้นเว็บของคุณ

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

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

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

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

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

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

ถ้าจะให้บริษัทเชื่อมต่อระบบสร้างฝั่งของคุณ ให้คุยเรื่องนี้ก่อนรับใบเสนอราคา เพื่อให้ขอบเขตงานอธิบาย API ที่จะเชื่อมจริง หน้า API ท่องเที่ยวคือจุดเริ่มต้น

บรีฟที่อ่อนทำให้คุณเสียอะไร

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

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

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

แต่ละกรณีคือประโยคเดียวที่หายไปจากบรีฟ ส่วนโค้ดไม่มีปัญหาเลยสักครั้ง

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

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

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