So sánh API du lịch: chấm theo trục, đừng chấm nhà cung cấp

Bạn mở ba bộ slide của ba nhà cung cấp trong ba tab. Bộ nào cũng có một slide liệt kê dài các hãng bay, một slide về số lượng khách sạn, sandbox, REST và JSON, cùng một email hỗ trợ. Bạn lập bảng tính, đánh dấu vào mọi ô, và bảng tính kết thúc bằng hòa. Đó là kết cục quen thuộc của một cuộc so sánh API du lịch làm theo kiểu checklist tính năng — và đó là kết cục sai, vì những khác biệt quyết định năm tới của bạn chỉ lộ ra sau khi go-live: ở booking đã thành công phía nhà cung cấp nhưng bị timeout phía bạn, ở khoản hoàn tiền không ai xử lý được, ở hãng bay có trong danh sách nhưng không thể xuất vé qua đường này.
Bài viết này dành cho developer hoặc trưởng nhóm kỹ thuật phải đưa ra quyết định đó và bảo vệ nó về sau. Bài không xếp hạng nhà cung cấp. Bài đưa cho bạn các trục để so sánh, một kế hoạch dùng thử dành phần lớn thời gian cho các tình huống lỗi, và vài câu hỏi ngắn giúp bạn nhanh chóng biết mình đang nói chuyện với nhà cung cấp thật hay với người bán lại nguồn của người khác.
Vì sao checklist tính năng luôn hòa
Checklist hỏi một khả năng có tồn tại hay không. Gần như API du lịch nào cũng trả lời “có” cho gần như mọi dòng, vì các dòng được viết ở mức trang marketing: tìm kiếm, báo giá, đặt chỗ, hủy, xuất vé, webhook, sandbox. Câu hỏi thực sự tách chúng ra không phải là cancel có tồn tại không, mà là chuyện gì xảy ra khi bạn gọi nó trên một booking đã xuất vé mười hai tiếng trước giờ bay, với giá vé có phí phạt, qua một đường mà nội dung đến từ bên thứ ba. Checklist không có cột nào cho chuyện đó.
Còn vấn đề thứ hai. Người điền checklist thường chính là nhà cung cấp. Bạn đang chấm điểm lời tự giới thiệu của họ.
So sánh API du lịch theo trục, không theo nhà cung cấp
Thay bảng “nhà cung cấp × tính năng” bằng các trục do chính bạn chấm, dựa trên bằng chứng thu được trong giai đoạn dùng thử. Bảng dưới đây là bảng chúng tôi sẽ dùng. Bạn có thể đặt trọng số khác cho từng dòng — doanh nghiệp chỉ bán khách sạn ít quan tâm chuyện xuất vé hơn — và nên tranh luận với nó trước khi áp dụng.
| Trục | Checklist hỏi gì | Điều thực sự cần tìm hiểu | Câu trả lời yếu nghe thế nào |
|---|---|---|---|
| Độ phủ | Bao nhiêu hãng bay và khách sạn? | Bao nhiêu trong số đó có thể tìm, đặt VÀ xuất vé hoặc xác nhận qua API này, ở các thị trường của bạn | Một con số lớn, không chia nhỏ |
| Độ sâu | Có endpoint hủy không? | Những thao tác sau đặt chỗ nào được tự động hóa theo từng nguồn nội dung: void, hoàn tiền, reissue, sửa tên, dịch vụ bổ trợ | “Đội vận hành của chúng tôi lo việc đó” |
| Độ tin cậy của giá | Giá có theo thời gian thực không? | Giá lúc đặt lệch giá lúc tìm thường xuyên đến đâu, và API báo cho bạn bằng cách nào | “Giá luôn là giá live” |
| Ngữ nghĩa của lỗi | Lỗi có được tài liệu hóa không? | Lỗi có cho biết booking đang ở trạng thái nào, chứ không chỉ báo là có gì đó hỏng | Một mã lỗi chung cho mọi thất bại |
| Tính idempotent | — | Gọi lại lệnh đặt chỗ có thể tạo ra booking thứ hai hay không | Im lặng, rồi “chúng tôi chưa gặp trường hợp đó” |
| Supplier of record | — | Hợp đồng của ai, số IATA của ai, vé đi qua BSP của ai | “Chúng tôi làm việc với mọi GDS lớn” |
| Tiếp cận và hỗ trợ | Có sandbox không? | Ai trả lời khi một PNR thật bị kẹt, và nhanh đến mức nào | Một form gửi ticket, không có người liên hệ cụ thể |
Có hai dòng không hề có câu hỏi nào trong checklist. Không phải ngẫu nhiên: đó là những dòng tốn kém nhất khi xảy ra sự cố, và cũng là những dòng mà slide của nhà cung cấp ít khi tự nói ra nhất.
Độ phủ không phải độ sâu
Danh sách hãng bay là slide gây hiểu lầm nhất trong mọi bộ slide. Một danh sách vài trăm hãng có thể mang nhiều nghĩa khác nhau, và chỉ một trong số đó là thứ bạn cần.
Một số hãng đi qua GDS và có thể đặt, xuất vé trọn vẹn từ đầu đến cuối. Một số đi qua kết nối NDC, nơi phần tìm kiếm có thể chạy tốt nhưng các dịch vụ sau đặt chỗ — đổi vé, hoàn một phần, thêm hành lý — với hãng đó vẫn có thể làm tay. Một số là hãng giá rẻ có nội dung được tổng hợp từ một đại lý bán lại khác; bạn hiển thị được, đôi khi đặt được, rồi vé về qua một đường bạn không kiểm soát, với thời gian bạn không thể hứa với khách. Và có hãng nằm trong danh sách chỉ vì từng có một giá vé xuất hiện trong kết quả tìm kiếm.
Một hãng bay bạn hiển thị được nhưng không xuất vé được thì không phải là độ phủ. Với sản phẩm bán lẻ, điều đó còn tệ hơn là không có, vì khách chọn, thanh toán, rồi ngồi chờ.
Khách sạn cũng có cùng hình dạng, chỉ khác từ ngữ. Số lượng cơ sở lưu trú bao gồm cả những nơi nhà cung cấp đã mapping lẫn chưa mapping; giá tĩnh được cache tuần trước nằm cạnh tình trạng phòng live; phòng allotment có release period nằm cạnh tồn kho free-sale. Hãy hỏi con số có thể đặt live tại những thành phố bạn đang bán, và hỏi họ gộp các bản trùng lặp giữa chính các nhà cung cấp của mình ra sao — cùng một khách sạn xuất hiện ba lần với ba mức giá là một ticket hỗ trợ đang chờ sẵn.
Bài kiểm tra thực tế rất hẹp. Ghi ra hai mươi chặng bay và hai mươi thành phố khách sạn chiếm phần lớn sản lượng của bạn, rồi đề nghị nhà cung cấp chạy đúng những thứ đó từ đầu đến cuối trong sandbox: tìm, báo giá, đặt, xuất vé hoặc xác nhận, hủy. Nhà cung cấp có chiều sâu sẽ làm mà không cần rào đón. Nhà cung cấp chỉ có slide sẽ bắt đầu nói về slide.
Thử gì trong giai đoạn dùng thử: luồng lỗi, không phải luồng suôn sẻ
Sandbox nào cũng đặt thành công một vé phổ thông một chiều trên một chặng vắng. Sandbox được dựng ra chính là để trình diễn điều đó. Lưu lượng production của bạn sẽ dành một phần đáng kể đời sống ở những luồng còn lại, và giai đoạn dùng thử là lúc rẻ nhất để nhìn thấy chúng.
Hãy dùng giai đoạn dùng thử để chạy danh sách này, và ghi lại API trả về gì bên cạnh điều thực sự đúng sau đó:
- Giá thay đổi giữa lúc tìm và lúc đặt. Lệnh đặt thất bại, thành công với giá mới, hay trả về một phản hồi riêng yêu cầu bạn xác nhận? UI của bạn có phân biệt được mà không cần phân tích chuỗi thông báo không?
- Offer hết hạn. Tìm kiếm, chờ lâu hơn thời hạn offer của nhà cung cấp, rồi đặt. Hết hạn là một lỗi riêng, hay trùng với lỗi “nhà cung cấp không phản hồi”?
- Hết chỗ lúc đặt. Tồn kho biến mất giữa lúc báo giá và lúc đặt. Booking ở trạng thái nào, và khoản ủy quyền thanh toán có được giải phóng không?
- Gửi lại sau timeout. Gửi yêu cầu đặt chỗ, cắt kết nối trước khi có phản hồi, rồi gửi lại. Giờ bạn có một PNR hay hai? Riêng phép thử này cho bạn biết về nhà cung cấp nhiều hơn toàn bộ phần còn lại của giai đoạn dùng thử cộng lại.
- Đã tạo booking, xuất vé thất bại. API có báo được một PNR tồn tại nhưng chưa xuất vé, và có cho bạn biết hạn xuất vé không?
- Thất bại một phần. Yêu cầu khách sạn nhiều phòng, một phòng xác nhận còn một phòng không. Vé khứ hồi mà chiều đi và chiều về đến từ hai nguồn khác nhau.
- Hủy ngoài thời hạn miễn phí. Phí phạt được báo trước khi bạn xác nhận, hay chỉ phát hiện trên hóa đơn?
- Nhà cung cấp gặp sự cố. Hỏi nhà cung cấp cách mô phỏng. Nếu họ không làm được, hỏi khách hàng của họ đã biết hệ thống hành xử thế nào bằng cách nào.
Với mỗi tình huống bạn chấm hai điều. Một: API có nói thật về trạng thái booking không? Hai: code của bạn có hành động dựa trên sự thật đó mà không cần người đọc văn bản tự do không? Một API thất bại rõ ràng dễ sống chung hơn một API thành công mập mờ.
Chúng tôi đã viết chi tiết hơn về phía vé máy bay trong bài những điều tài liệu API đặt vé máy bay bỏ qua, và về thiết kế client cho các nhà cung cấp khách sạn chậm trong bài về tình trạng phòng khách sạn. Cả hai đều là tài liệu đi kèm hữu ích cho kế hoạch dùng thử.
Những câu hỏi lật tẩy một aggregator mỏng
Aggregator không có gì sai. Phần lớn nội dung du lịch đến tay phần lớn người bán qua một aggregator. Rủi ro nằm ở loại mỏng: một lớp bán lại API của lớp khác, cộng thêm biên lợi nhuận, và không nắm hợp đồng với nhà cung cấp lẫn bàn vận hành. Khi có sự cố, câu trả lời phải đi ngược lên hai công ty rồi quay về.
Năm câu hỏi làm lộ điều này rất nhanh:
- Ai là supplier of record của booking này? Booking dựa trên hợp đồng của ai với hãng bay hoặc khách sạn?
- Vé đi qua số IATA và BSP của ai? Nếu câu trả lời là “của đối tác”, hãy hỏi ai nhận ADM khi một điều kiện giá vé bị vi phạm.
- Khi tôi gọi cancel, phía các anh chuyện gì xảy ra? Một lệnh gọi tự động tới nhà cung cấp, hay một hàng đợi do người xử lý?
- Tôi có xem được lỗi gốc từ phía trên không? Một lớp mỏng thường ép mọi thất bại về một mã duy nhất, vì nó không hiểu hết các lỗi nó nhận được.
- Tôi gọi ai khi một booking thật bị kẹt, và người đó gọi ai? Hãy đếm số chặng.
Không câu trả lời nào tự nó đủ để loại. Dùng số IATA của đối tác có thể ổn nếu hợp đồng ghi rõ ai chịu debit memo. Điều quan trọng là nhà cung cấp trả lời chính xác và nhanh. Những câu trả lời mơ hồ ở đây chính là những câu bạn sẽ nhận lại sau này, trên production, vào một giờ tệ hơn.
Chọn sai thì phải trả giá thế nào
Tích hợp là phần rẻ. Những phần đắt đến sau và không xuất hiện trong bất kỳ bản ước tính nào.
Lỗi đặt trùng nghĩa là khách bị trừ tiền hai lần và một PNR bạn phải tìm rồi hủy bằng tay, có khi sau khi hết thời hạn void miễn phí. Một booking thành công ở phía trên trong khi phía bạn ghi nhận thất bại nghĩa là ghế bị giữ, rồi tự hủy, và một khách hàng tin rằng mình đã có chỗ. Một hãng bay bạn hiển thị nhưng không xuất vé được nghĩa là hoàn tiền, xin lỗi và một khách hàng không quay lại. ADM cho một điều kiện giá vé bị đường của nhà cung cấp vi phạm sẽ rơi vào người sở hữu vé — hãy biết trước người đó có phải là bạn không.
Rồi còn chi phí chuyển đổi. Mỗi điểm kỳ quặc của nhà cung cấp mà bạn hấp thụ — một mã trạng thái mang hai nghĩa, một trường lúc là chuỗi lúc không — đều đi vào mô hình dữ liệu của bạn. Hai năm sau, lựa chọn API không còn là một tích hợp có thể thay trong một sprint; nó đã thành hình dạng của bảng booking. Đó mới là lý do thật để so sánh kỹ ngay bây giờ.
API của chính chúng tôi nằm ở đâu trong khung này
Chúng tôi cung cấp API vé máy bay và khách sạn. Quyền truy cập bắt đầu bằng một cuộc trao đổi chứ không phải một khóa tự phục vụ, điều mà một số developer thấy chậm; lý do là chính cuộc trao đổi đó là nơi các câu hỏi ở trên được đặt ra theo cả hai chiều — bạn cần những chặng và thành phố nào, nội dung nào bạn thực sự xuất vé hoặc xác nhận được, và ai xử lý việc gì sau khi đặt. Nếu bạn đang so sánh, hãy mang danh sách này theo. Cuộc trao đổi bắt đầu ở trang API du lịch.
Dù chọn gì, hãy chọn từ nhật ký dùng thử chứ không phải từ bộ slide. Bộ slide cho bạn biết nhà cung cấp muốn trở thành gì. Các luồng lỗi cho bạn biết họ thực sự là gì.