API đặt phòng khách sạn và vé máy bay: một chuyến đi, hai booking

Ticket ghi: "thêm khách sạn vào luồng vé máy bay, một trang thanh toán, một tổng tiền". Đó là yêu cầu hợp lý từ một product manager, và nghe như việc của một ngày, vì bạn đã có tìm kiếm chuyến bay và đã có trang thanh toán. Ba tuần sau, cả nhóm tranh cãi về việc phải làm gì khi hãng bay xác nhận còn khách sạn thì không. Một API đặt phòng khách sạn và vé máy bay không phải một tích hợp với hai loại kết quả. Đó là hai tích hợp dùng chung một giỏ hàng.
Code thừa nhận điều đó càng sớm thì càng ít phải viết lại. Phần dưới đây là thứ các hướng dẫn tích hợp bỏ qua: hai nửa khác nhau thế nào, nửa nào cần chốt trước, và chuyến đi phải là gì trong mô hình dữ liệu của bạn.
Hai nửa không vận hành giống nhau
Cả hai đều trả về JSON với một mức giá và một mã tham chiếu, nên nhìn trên đường truyền thì giống nhau. Chúng không giống nhau ở điều chúng hứa với bạn sau khi bạn đã có mã tham chiếu.
| Câu hỏi | Chuyến bay | Khách sạn |
|---|---|---|
| Bạn nắm gì sau khi đặt | Một đặt chỗ (PNR) chưa phải là vé | Một xác nhận thường đã chính là thứ bạn bán |
| Giá còn hiệu lực bao lâu | Đến khi giá vé được tính lại lúc đặt, có thể khác với lúc tìm kiếm | Đến khi rate hết hạn, và rate có thể đổi giữa lúc kiểm tra phòng trống và lúc đặt |
| Điều gì xác nhận nó | Việc xuất vé, thường có hạn chót | Xác nhận của nhà cung cấp, lúc ngay lập tức, lúc ở trạng thái chờ |
| Hủy bằng cách nào | Void nếu bắt kịp sớm, nếu không thì hoàn tiền theo điều kiện giá vé, thường kèm phí phạt | Hủy theo chính sách của rate, nhiều rate được hủy miễn phí đến một mốc |
| Điều gì thay đổi con số vào phút chót | Giá vé, thuế, đôi khi cả đơn vị tiền tệ của giá vé | Thuế và phí trả tại chỗ ở, gói ăn, căn phòng thực sự được xếp |
Bạn có thể không đồng ý với một dòng nào đó, vì các nhà cung cấp khác nhau, nhưng không thể phản bác hình dạng của nó: một nửa có bước xuất vé, nửa kia có khung thời gian hủy, và chúng không trùng nhau về thời gian. Phía chuyến bay chúng tôi đã viết trong tích hợp API đặt vé máy bay, còn vấn đề nhà cung cấp chậm ở phía khách sạn trong thiết kế client cho API phòng trống khách sạn. Bài này bắt đầu ở chỗ hai bài kia kết thúc, tại mối nối.
Nên đặt nửa nào trước?
Không ai nói với bạn rằng đây là một quyết định thiết kế, và chính nó quyết định một lỗi tốn bao nhiêu.
Giả sử khách mua chuyến bay và khách sạn cho cùng ngày. Bạn gửi một booking rồi gửi booking còn lại. Có ba khả năng: cả hai thành công, hoặc một cái thất bại, hoặc một cái thất bại sau khi cái kia đã thành công. Khả năng đầu là một ngày đẹp trời. Hai khả năng còn lại quyết định hàng đợi hỗ trợ của bạn.
Nếu bạn xuất vé máy bay trước rồi khách sạn từ chối, bạn có một khách hàng có ghế bay tới một thành phố mà không có phòng, đã bị trừ tiền, và một khoản hoàn tiền cho tấm vé có phí phạt. Nếu bạn đặt khách sạn trước rồi chuyến bay thất bại, bạn đang giữ một phòng thường có thể hủy miễn phí, nên việc sửa chữa rẻ. Rủi ro ngược lại cũng có thật, vì một rate khách sạn không được hủy là thứ tệ hơn để giữ, nên hãy đọc điều kiện hủy của rate trước khi để nó đi trước.
Đây là quy tắc kinh nghiệm, không phải luật, và điều quan trọng là bạn chọn thứ tự một cách có chủ ý. Chốt nửa dễ hủy hơn trước nửa khó hủy hơn, kiểm tra lại giá của cả hai ngay trước khi bất kỳ nửa nào được chốt, và ghi lại bạn sẽ làm gì cho từng kết quả trong ba kết quả. Người review hiếm khi hỏi. Khách hàng thì luôn phát hiện ra.
Một chuyến đi, hai booking
Hình dạng trụ vững là một bản ghi chuyến đi sở hữu hai booking, mỗi booking có mã tham chiếu, trạng thái và điều kiện riêng. Khách hàng thấy một tổng tiền. Cơ sở dữ liệu thấy hai dòng, và tổng tiền là phép cộng do bạn tính, không phải thứ tồn tại ở phía nhà cung cấp.
Giữ hai trạng thái tách biệt. "Đã xác nhận" của khách sạn và "đã xuất vé" của chuyến bay không phải cùng một trạng thái, và một cột trạng thái duy nhất gộp chúng lại, sớm hay muộn sẽ ghi "đã đặt" lên một chuyến đi mới đặt được một nửa.
Cũng giữ riêng hai bộ điều kiện thay đổi, và hiển thị chúng. Một tổng tiền được hiển thị che đi việc đổi ngày là thay đổi miễn phí ở nửa này nhưng mất phí ở nửa kia. Nếu frontend hiển thị "đổi ngày" như một nút duy nhất, hãy quyết định nó làm gì khi chỉ một nửa đổi được, trước khi khách hàng phát hiện thay bạn. Markup cũng vậy: nếu bạn cộng markup theo từng dịch vụ như phần lớn người bán, tổng chuyến đi là hai khoản markup, và việc hoàn tiền một nửa phải biết nó đang trả lại khoản markup nào. Tiền là chỗ một chuyến đi ghép trở nên đắt đỏ, vì các dòng được quyết toán theo những mốc thời gian khác nhau, và tiền hoàn vé máy bay không về cùng lúc với việc hủy khách sạn.
Nền tảng này đứng ở đâu
Nói thẳng: nền tảng cung cấp API cho chuyến bay và khách sạn, và quyền truy cập bắt đầu bằng một cuộc trao đổi chứ không phải một key tự lấy. Dịch vụ được bật theo từng tenant, nên một tenant bán khách sạn mà không bán tour sẽ không phải mang phần tour. Không có gì ở đây hứa một lệnh gọi duy nhất đặt cả hai nửa một cách nguyên tử, và bạn không nên thiết kế như thể có. Hãy coi chúng là hai booking đúng như bản chất, nằm dưới một chuyến đi do bạn sở hữu.
Nếu bạn muốn xem các lệnh gọi và điều kiện thực tế trước khi xây dựng quanh chúng, hãy bắt đầu từ trang API du lịch và mang theo thứ tự đặt mà bạn định dùng. Nếu bạn vẫn đang cân nhắc quyền truy cập miễn phí mang lại gì, bài API đặt phòng khách sạn miễn phí trình bày các kiểu miễn phí.
Làm sai thì tốn gì
Phiên bản đắt đỏ là phiên bản lặng lẽ. Khách đã có vé tới một thành phố còn phòng thì mất, và điều đầu tiên bạn nghe là một tin nhắn lúc nửa đêm, từ sân bay. Rẻ hơn nhưng vẫn có thật: trang thanh toán hiển thị một tổng tiền khiến người ta yên tâm rồi, sau một lần kiểm tra giá, ra con số thứ hai mà khách chưa đồng ý; một khoản hoàn tiền trả lại vé máy bay mà quên khách sạn; và một trạng thái ghi "đã đặt" trong khi nhà cung cấp nói khác.
Không điều nào trong số đó cần một giải pháp khéo léo. Chỉ cần chuyến đi là một đối tượng thật, thứ tự là một quyết định có người ghi lại, và kiểm tra lại cả hai giá vào khoảnh khắc cuối trước khi bất kỳ nửa nào được chốt. Xây điều đó một lần và trang thanh toán có thể trông đơn giản đúng như ticket yêu cầu.