Thay thế Amadeus Self Service API: chuyển đổi trong một tuần

Bạn phát hiện ra qua một lần kiểm tra sức khỏe hệ thống thất bại, hoặc qua một người dùng. Endpoint tìm kiếm mà ứng dụng vé máy bay của bạn gọi từ bản thử nghiệm đầu tiên bỗng trả về một lỗi bạn chưa từng thấy, và cổng quản lý khóa API cũng không còn nữa. Nếu bạn đang tìm giải pháp thay thế Amadeus Self Service API, có lẽ bạn đang ở đúng tình thế đó: một sản phẩm đang chạy, một bộ mã được viết quanh định dạng yêu cầu của một nhà cung cấp, và rất ít thời gian trước khi người dùng nhận ra chức năng tìm kiếm đã hỏng.
Về nhà cung cấp này, chỉ có một sự thật đáng nói, và bài viết chỉ nói một điều đó. Amadeus đã ngừng cổng Self-Service API vào ngày 17 tháng 7 năm 2026, và các nhà phát triển mới được chuyển sang kênh Enterprise, vốn hoạt động theo hợp đồng. Bài này nói về chuyện đó đến đây là đủ. Câu hỏi hữu ích hơn là thứ gì sẽ thay thế nó, và làm sao chuyển đổi trong khoảng một tuần mà không phải xây lại những phần vẫn đang hoạt động.
Tự phục vụ thực ra đã mang lại cho bạn điều gì
Rất dễ nhớ về cổng cũ như "một API vé máy bay" rồi đi tìm một API vé máy bay khác. Nhưng như vậy là bỏ qua điều khiến nó hữu ích với một startup hai người hay một dự án làm vào cuối tuần. Chủ yếu là ba điều:
- Môi trường thử nghiệm có được trong một buổi chiều. Đăng ký, nhận khóa, gọi tìm kiếm. Không ai hỏi công ty bạn làm gì.
- Trả theo mức dùng. Bạn trả cho những gì mình gọi, nên một sản phẩm có một trăm người dùng tốn đúng chi phí của một sản phẩm có một trăm người dùng.
- Không có quy trình bán hàng. Không ai phải duyệt bạn trước khi bạn được viết mã.
Hợp đồng Enterprise đảo ngược cả ba điều đó. Quyền truy cập đến sau một cuộc trao đổi thương mại, giá cả được đàm phán, còn môi trường thử nghiệm chỉ có khi giấy tờ xong. Từ phía người bán, không điều nào là vô lý; phân phối nội dung của hãng hàng không đi kèm những nghĩa vụ thật sự. Nhưng nó làm thay đổi kế hoạch của bạn. Nếu bạn định chỉ đổi khóa API này sang khóa API khác, thì nói thẳng là hầu hết các giải pháp thay thế nghiêm túc không còn vận hành như thế nữa, kể cả giải pháp mà trang này cung cấp. Phần dưới sẽ nói thêm.
Ba hướng thay thế Amadeus Self Service API
Bỏ tên các nhà cung cấp đi, chỉ còn ba loại giải pháp thay thế. Chúng khác nhau ít ở JSON mà nhiều ở chỗ bạn ký hợp đồng với ai và cuối cùng ai là người xuất vé.
| Hướng đi | Thời gian đến đơn đặt chỗ thật đầu tiên | Nội dung có thể kỳ vọng | Ai giữ quyền xuất vé |
|---|---|---|---|
| Hợp đồng trực tiếp với GDS | Lâu nhất: xét duyệt thương mại, chứng nhận, rồi mới đến phát triển | Nội dung GDS rộng; NDC và hãng giá rẻ tùy vào thỏa thuận bạn ký | Chính bạn, nếu có chứng nhận IATA; nếu không, bạn vẫn cần một bên có chứng nhận |
| API của đơn vị tổng hợp (aggregator) | Trung bình: tiếp nhận nhẹ hơn, nhưng vẫn nên chuẩn bị ký hợp đồng | Kết hợp GDS, NDC và hãng giá rẻ, tùy nguồn mà aggregator đã kết nối | Thường là aggregator, hoặc một đối tác xuất vé của họ |
| API của consolidator | Thường là con đường ngắn nhất đến một vé đã xuất, vì chuyện xuất vé đã được giải quyết sẵn | Những gì consolidator đang bán: giá hợp đồng và giá net của họ, cộng với nội dung từ các nhà cung cấp của họ | Consolidator, bằng chứng nhận của chính họ |
Bạn có thể không đồng ý với cột ở giữa, và với trường hợp của riêng mình thì bạn nên tự đánh giá. Một đội đã có chứng nhận và có người phụ trách thương mại có thể thấy hướng GDS nhanh hơn bảng gợi ý. Nhưng phần lớn nhà phát triển xây dựng trên sandbox tự phục vụ chưa bao giờ có quyền xuất vé, và cột cuối cùng quyết định bao nhiêu phần sản phẩm của bạn vẫn còn chạy được sau khi chuyển.
Lý do là thế này. Tìm kiếm và báo giá là thao tác đọc; cả ba hướng đều cho bạn những thứ đó. Xuất vé là một hành vi tài chính, được thực hiện dưới chứng nhận của ai đó và quyết toán qua BSP hoặc hệ thống tương đương, và nếu người đó không phải bạn, bạn cần một thỏa thuận với họ. Những đội bỏ qua câu hỏi này rốt cuộc chỉ có một trang tìm kiếm đẹp và một nút đặt vé tạo ra những đơn đặt chỗ không ai trả tiền.
Nội dung là cột còn lại cần đọc chậm. Nội dung GDS và nội dung NDC không phải cùng một bộ giá vé, và các hãng giá rẻ thường không nằm ở bên nào. Nếu người dùng của bạn chủ yếu bay chặng ngắn trong một khu vực có nhiều hãng giá rẻ, một hướng đi có độ phủ GDS rất tốt vẫn có thể trả về kết quả nghèo nàn. Chúng tôi đã phân tích sự khác biệt này trong bài NDC API hay GDS: điều gì đã thay đổi với người tích hợp.
Cách truy cập ở đây, và vì sao đây cũng không phải một chiếc khóa
Nền tảng này cung cấp API vé máy bay và khách sạn. Việc 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ụ. Chúng tôi nói thẳng điều này vì kết quả tệ nhất với bạn trong tuần này là đăng ký ở đâu đó với kỳ vọng như trải nghiệm cũ, rồi đến ngày thứ tư mới phát hiện có một bước phê duyệt của con người chắn đường.
Cuộc trao đổi chủ yếu xoay quanh các câu hỏi trong bảng: bạn đang xây gì, người dùng của bạn là ai, bạn cần xuất vé hay chỉ cần tìm kiếm và báo giá, và bạn bán vào những thị trường nào. Các câu trả lời đó quyết định bạn nhận được nội dung nào và đơn đặt chỗ được quyết toán ra sao. Nếu muốn bắt đầu, hãy vào trang API du lịch.
Dù chọn nơi nào, hãy hỏi cùng một điều trong email đầu tiên: có khóa thử nghiệm tự phục vụ không, và cần làm gì trước khi lên môi trường production? Một câu trả lời rõ ràng là dấu hiệu tốt cho phần còn lại của quá trình tích hợp. Một câu trả lời mơ hồ cũng cho bạn biết điều gì đó.
Danh sách kiểm tra khi chuyển đổi, theo thứ tự hỏng hóc
Hầu hết các tích hợp tự phục vụ đều có cùng một cấu trúc: tìm kiếm, báo giá, tạo đơn, xuất vé, rồi xử lý mọi thứ xảy ra sau khi vé đã tồn tại. Hãy kiểm thử lại từng bước với nhà cung cấp mới như thể bạn chưa từng viết nó. Tên các yêu cầu sẽ khác; thứ gây rắc rối là những giả định nằm sâu trong mã của bạn.
- Tìm kiếm. Ánh xạ mô hình truy vấn của bạn (điểm đi, điểm đến, ngày, hành khách, hạng ghế) sang yêu cầu mới. Kiểm tra cách truyền tuổi trẻ em và em bé, hành trình nhiều chặng có phải là một lệnh gọi riêng không, và kết quả rỗng trông như thế nào. Danh sách rỗng và lỗi là hai chuyện khác nhau, mà giao diện của bạn có lẽ đang xử lý chúng như nhau.
- Định danh offer. Tìm hiểu một offer id còn hiệu lực bao lâu và có tồn tại sau khi tải lại trang không. Mã lưu offer trong phiên rồi mười phút sau mới báo giá sẽ hỏng theo những cách mới.
- Báo giá. Với hầu hết nhà cung cấp, báo giá lại trước khi đặt không phải là tùy chọn. Hãy xử lý trường hợp giá đã thay đổi, và quyết định người dùng sẽ thấy gì khi điều đó xảy ra.
- Đơn đặt chỗ. Tên hành khách, các trường giấy tờ, thông tin liên hệ. Kiểm tra định dạng phía bạn trước khi gửi; một đơn bị từ chối sau khi khách đã thanh toán là lỗi đắt giá nhất trong danh sách này.
- Vé. Xác nhận lệnh tạo đơn có xuất vé luôn không, hay xuất vé là một bước riêng có giới hạn thời gian riêng. Hãy biết vé được xuất dưới quyền của ai trước khi bạn nhận tiền của bất kỳ ai.
- Sau xuất vé. Hủy, void, hoàn tiền, thay đổi lịch bay. Đây là những lệnh gọi mà bản thử nghiệm không bao giờ cần còn sản phẩm thật cần ngay trong tháng đầu. Hãy hỏi chúng có trong API hay phải đi qua bộ phận hỗ trợ.
Để có kế hoạch kiểm thử đầy đủ hơn, gồm cả những gì được giả lập và những gì không bao giờ được giả lập, xem kế hoạch kiểm thử sandbox cho API du lịch của chúng tôi. Nếu bạn tiếp cận từ phía tích hợp, bài tích hợp API đặt vé máy bay đi qua toàn bộ quy trình.
Cái giá của một lần chuyển đổi vội vàng
Cách làm hấp dẫn nhất là bọc nhà cung cấp mới phía sau giao diện client cũ và phát hành ngay khi tìm kiếm trả về kết quả. Tìm kiếm sẽ trông ổn. Thứ hỏng là mọi thứ mà bản demo không cho thấy.
Một mức giá thay đổi giữa lúc tìm kiếm và lúc đặt, hiện ra với người dùng dưới dạng lỗi thô, sẽ làm mất đơn đặt chỗ. Một đơn được tạo mà không xuất vé, vì nhà cung cấp mới tách hai bước còn mã của bạn thì không, để lại một hành khách tưởng mình có vé nhưng thực ra không có. Một quy trình hoàn tiền lặng lẽ không làm gì cho đến khi có người viết thư cho bộ phận hỗ trợ sẽ biến thành một khoản chargeback. Mỗi chuyện xảy ra một lần thì còn chịu được. Lặp lại trên toàn bộ người dùng, chúng khiến bạn mất đi niềm tin mà một sản phẩm du lịch nhỏ dựa vào để sống.
Còn một cái giá âm thầm hơn. Nếu bạn chọn một hướng vì nó nhanh nhất trong tuần này và hóa ra nó không có nội dung người dùng của bạn tìm kiếm, bạn sẽ phải chuyển đổi hai lần. Dành một ngày cho các câu hỏi về nội dung và xuất vé trước khi viết dòng mã nào là khoản bảo hiểm rẻ nhất của cả quá trình.
Đại khái một tuần
Ngày đầu dành cho các câu hỏi: hướng nào, nội dung nào, quyền xuất vé của ai. Ngày thứ hai và thứ ba cho tìm kiếm và báo giá với nhà cung cấp mới. Ngày thứ tư cho đặt chỗ và xuất vé từ đầu đến cuối, kể cả các trường hợp lỗi. Ngày thứ năm cho phần sau xuất vé và đọc lại log của chính bạn. Nếu cuộc trao đổi với nhà cung cấp kéo dài hơn một ngày, hãy bắt đầu viết mã theo tài liệu của họ song song; cấu trúc yêu cầu hiếm khi thay đổi một khi bạn đã thấy nó.
Nó sẽ không giống buổi chiều bạn lấy được khóa tự phục vụ đầu tiên. Cũng không cần phải giống. Thứ bạn đang xây bây giờ phải xuất được những chiếc vé có người đứng ra chịu trách nhiệm.