API giá vé máy bay: vì sao con số hiển thị chưa phải là giá vé

Bản demo chạy tốt. Một lập trình viên gắn API giá vé máy bay vào lịch những ngày bay rẻ nhất, bảng lấp đầy các con số và mọi người trong phòng đều hài lòng. Rồi khách thật đầu tiên chọn một ngày, thấy ở trang kết quả con số thấp hơn trang thanh toán, và gửi cho bộ phận hỗ trợ một ảnh chụp màn hình. Không có gì hỏng cả. API đã làm đúng điều được yêu cầu: nó trả lời một câu hỏi về giá, còn website coi câu trả lời ấy như một lời hứa.
Giá là một đề nghị có trí nhớ ngắn
Giá vé máy bay không phải nhãn cố định dán lên ghế. Nó là một nhóm giá mở ra rồi đóng lại khi ghế được bán, và con số gắn với nó thay đổi theo cơ cấu hành khách, chính xác các chuyến bay, thuế của các sân bay liên quan và đồng tiền dùng để báo giá. Phản hồi về giá là ảnh chụp nhanh của tất cả điều đó, ở một thời điểm, cho một bộ đầu vào. Coi nó là sự thật về quá khứ thì bạn sẽ xây đúng thứ cần xây; coi nó là sự thật về hiện tại thì bạn sẽ mất một tháng để xử lý hoàn tiền.
Vì vậy câu hỏi hữu ích cho lập trình viên không bao giờ chỉ là giá bao nhiêu. Mà là đây là loại giá nào, đã cũ đến đâu, và hệ thống sẽ làm gì nếu hóa ra nó sai.
Ba con số đều được gọi là giá
Hầu hết nhà cung cấp đều trả về cả ba ở đâu đó trong tài liệu, thường dưới cùng một tên trường. Hãy tách chúng ra trong mô hình dữ liệu của bạn ngay từ ngày đầu.
| Trạng thái | Đến từ đâu | Mức độ mới | Bán được không? | Nên hiển thị gì |
|---|---|---|---|---|
| Giá để xem | Tìm kiếm từ bộ nhớ đệm hoặc tổng hợp, xây cho tốc độ và độ rộng | Có thể đã cũ và không được tính cho hành khách của bạn | Không | Chữ „từ” và nhãn cho biết giá có thể đổi |
| Đề nghị đã định giá | Yêu cầu trực tiếp cho đúng hành trình, loại hành khách và hạng giá | Mới tại thời điểm gọi, có hạn dùng hoặc tín hiệu định giá lại | Có, cho đến khi hết hạn | Tổng tiền, thuế chi tiết, điều kiện giá vé |
| Số tiền vé đã xuất | Số tiền hãng hay hệ thống xuất vé thực sự tính khi đặt chỗ | Cuối cùng | Đã bán | Biên nhận; đối chiếu với đề nghị |
Giá để xem là thứ làm nên lịch giá và huy hiệu „rẻ nhất từ”, và đó là thứ rất đáng xây. Chỉ là nó không cùng một đối tượng với dòng thứ hai. Sai lầm là một trường price duy nhất mà cả ba đổ vào.
Trong thực tế điều này nghĩa là ba kiểu dữ liệu hoặc ba bảng riêng trong mã của bạn, chứ không phải một cái có cờ đánh dấu. Giá để xem được phép sai chút ít vì nó chỉ là lời mời bấm. Đề nghị đã định giá là cam kết bạn sắp đưa ra dưới tên mình, nên nó được lưu cùng thời điểm lấy, các đầu vào tạo ra nó và mã định danh mà nhà cung cấp sẽ cần lại khi đặt chỗ. Số tiền vé đã xuất là kế toán. Khi bộ phận hỗ trợ hỏi vì sao khách trả số tiền khác với email, câu trả lời nằm ở khoảng chênh giữa các dòng, và bạn chỉ đọc được khoảng chênh đó nếu đã giữ cả ba.
Phản hồi về giá phải mang những gì
Một con số trần không đủ để xây quy trình thanh toán. Khi đọc phản hồi mẫu của nhà cung cấp, hãy tìm những điều sau, và hãy nghi ngờ bất cứ thứ gì đến dưới dạng văn bản tự do.
- Đồng tiền, ghi ngay trong phản hồi, không suy ra từ tài khoản của bạn.
- Giá cơ bản và thuế tách riêng, để bạn hiển thị chi tiết và để thay đổi thuế không trông như thay đổi giá vé.
- Loại hành khách mà giá được tính cho. Giá người lớn nhân ba không phải giá vé gia đình.
- Điều kiện vé và hành lý dưới dạng dữ liệu có cấu trúc, vì chúng quyết định lựa chọn rẻ có thật sự rẻ hơn với khách của bạn hay không.
- Hạn dùng hoặc tín hiệu định giá lại: một mốc thời gian, hoặc tuyên bố rõ ràng rằng bạn phải định giá lại trước khi đặt chỗ.
Mục cuối là mục người ta hay bỏ qua. Nếu không có gì trong phản hồi cho biết đề nghị sống được bao lâu, bạn đang đoán, và việc đoán ấy diễn ra trên môi trường thật.
Định giá lại trước khi đặt chỗ, không phải sau
Nhịp làm việc an toàn nhất có một quy tắc trong đó. Tìm kiếm để xem. Khi khách chọn hành trình, hãy yêu cầu một đề nghị định giá trực tiếp cho đúng hành trình và hành khách đó. Cho khách thấy tổng số tiền ấy. Chỉ sau đó mới tạo đơn đặt chỗ. Nếu giá trực tiếp khác với giá ở trang kết quả, bạn nói với khách trước khi họ thanh toán, bằng lời rõ ràng, thay vì sau khi họ đã trả tiền.
Bỏ qua bước giữa thì bạn thừa hưởng khoản chênh. Hoặc bạn tính nhiều hơn số khách đã thấy và mất đơn ở trang thanh toán, hoặc bạn giữ con số thấp hơn và khoảng chênh lấy từ biên lợi nhuận của chính mình. Một đại lý nhỏ có thể chịu vài lần; nhưng không thể chịu nó như một thiết kế.
Hỏi những điều này bằng văn bản trước khi tích hợp
Tài liệu mô tả đường đi suôn sẻ. Hành vi làm bạn tốn tiền nằm trong câu trả lời cho một danh sách câu hỏi ngắn, và những câu trả lời ấy nên có trong email chứ không chỉ trong cuộc gọi.
- Giá trong phản hồi tìm kiếm là trực tiếp hay từ bộ nhớ đệm, và điều đó có được ghi ngay trên phản hồi không?
- Có lệnh gọi định giá riêng cho đúng hành trình không, và nó có bắt buộc trước khi đặt chỗ không?
- Điều gì xảy ra lúc đặt chỗ nếu giá đã đổi: từ chối, giá mới trong phản hồi, hay xuất vé âm thầm với số tiền mới?
- Thuế và phụ phí hãng được liệt kê thế nào, và chúng có thể thay đổi giữa lúc định giá và xuất vé không?
- Giá được tính bằng đồng tiền nào, và việc quy đổi diễn ra ở đâu nếu khách thấy đồng tiền khác?
- Đề nghị đã định giá còn hiệu lực bao lâu, và bạn sẽ biết bằng cách nào?
Nhà cung cấp trả lời chính xác những câu này là người đã nghĩ về khâu thanh toán. Người trả lời „lúc nào cũng cập nhật” thì chưa nói gì bạn có thể kiểm thử. Nếu bạn không thể tự thử hành vi đó, đó là lý do để nhìn lại toàn bộ hệ thống theo cách khác trước khi cam kết xây dựng xung quanh nó.
Làm sai thì tốn kém thế nào
Hiếm khi nó hỏng ầm ĩ. Nó hỏng dưới dạng một mức sụt nhỏ ở bước thanh toán mà không ai quy cho giá, dưới dạng các phiếu hỗ trợ mở đầu bằng „giá đã thay đổi”, dưới dạng một khách từng tin trang kết quả và giờ thì không. Nhân viên cuối cùng phải xác nhận lại giá vé bằng tay trước khi xuất vé. Rồi ai đó đề xuất quy tắc làm tròn giá lên cho chắc, và website trở nên đắt đúng ở màn hình mà mọi người so sánh. Mỗi điều đó là một khoản thuế đánh lên một quyết định vốn rẻ để làm đúng ngay từ đầu.
Nền tảng này đứng ở đâu
Nền tảng cung cấp API chuyến bay và khách sạn, kích hoạt theo từng tenant. Quyền truy cập bắt đầu bằng một cuộc trao đổi chứ không phải khóa tự phục vụ, nên không có biểu mẫu đăng ký nào đưa bạn token và bảng giới hạn tốc độ. Trang này không công bố độ trễ, phạm vi phủ hay số lượng giá vé, vì một con số mà chúng tôi không chỉ được cách kiểm thử thì không đáng in ra. Điều bạn có thể làm là mang các câu hỏi trên vào cuộc trao đổi đó và yêu cầu xem phản hồi cho một đề nghị đã định giá, không chỉ cho một lượt tìm kiếm. Nếu bạn đang ở giai đoạn này, trang API du lịch là nơi bắt đầu.