API Chuyến bay

Lịch giá vé

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 trả về giá vé rẻ nhất đã lưu đệm theo từng ngày cho chặng bay, theo tiền tệ của bạn, kèm độ mới của bộ nhớ đệm. Thêm returnFrom / returnTo để có tổng giá khứ hồi theo từng cặp ngày, và cabin để giới hạn hạng ghế. Dữ liệu được lấy từ bộ nhớ đệm giá của chúng tôi — tức thì và không bao giờ được tính là một lượt tìm kiếm tới nhà cung cấp — vì vậy hãy dùng nó để vẽ lịch hoặc dải “ngày rẻ nhất” trước khi tìm kiếm thật.

Tìm kiếm

POST /v1/flights/search với một slice cho chuyến một chiều, hai cho chuyến khứ hồi, tối đa sáu cho hành trình nhiều chặng; số hành khách theo loại; hạng ghế và số điểm dừng tối đa (maxStops) là tùy chọn. Với wait=true, phản hồi chứa mọi ưu đãi sau khi tất cả nhà cung cấp đã trả lời; với wait=false, bạn nhận một searchId và thăm dò GET /v1/flights/search/{searchId} bằng cursor cho đến khi complete là true.

Mỗi ưu đãi mang một offerId mờ, tổng tiền theo tiền tệ của bạn kèm chi tiết theo từng hành khách, slices → segments (hãng vận chuyển, số hiệu chuyến bay, giờ, loại máy bay, hạng ghế, hành lý), tóm tắt điều kiện giá vé và thời điểm hết hạn. Ưu đãi có hiệu lực trong suốt phiên tìm kiếm (khoảng 20 phút).

Giá và quy tắc

POST /v1/flights/offers/{offerId}/price xác thực lại giá vé với nhà cung cấp ngay trước khi bạn chốt và trả về giá đã xác nhận, thuế và các trường thông tin hành khách mà hãng bay yêu cầu (giấy tờ, ngày sinh, khách hàng thường xuyên). GET .../fare-rules trả về nội dung điều kiện phạt; GET .../ancillaries liệt kê hành lý trả phí và các tùy chọn bạn có thể thêm vào đơn.

Dịch vụ bổ sung (hành lý thêm)

GET /v1/flights/offers/{offerId}/ancillaries liệt kê các dịch vụ thêm có tính phí mà hãng bay cung cấp cho giá vé đó — hiện là hạn mức hành lý ký gửi thêm, mỗi mục có key, số kiện / trọng lượng và giá cho mỗi hành khách. Có tính phí nghĩa là chúng được định giá cộng thêm vào giá vé và tính tiền cùng đơn, khác với hạn mức hành lý đã bao gồm hiển thị trên chính ưu đãi.

Để mua, hãy thêm ancillaries[] vào POST /v1/flights/orders: mỗi dịch vụ thêm một mục với key và passengerIndex (chỉ số bắt đầu từ 0 trong passengers). Chúng được định giá, đặt và xuất vé cùng với đơn và xuất hiện trong tổng tiền vé của đơn. Không thể thêm dịch vụ bổ sung vào đơn đã xuất vé; chọn chỗ ngồi sẽ theo cùng cơ chế.

{
  "offerId": "fo_7Gk2Qp9LcKM5aGqrMQOIzJko",
  "passengers": [{ "type": "ADT", "gender": "M", "firstName": "SAM", "lastName": "TRAVELLER", "dateOfBirth": "1990-05-04" }],
  "contact": { "email": "[email protected]", "phone": "+971501234567" },
  "ancillaries": [{ "key": "BAG20-1", "passengerIndex": 0 }]
}

Tạo đơn

POST /v1/flights/orders với offerId, danh sách hành khách (họ tên như trên hộ chiếu, loại, ngày sinh, giấy tờ cho hành trình quốc tế), người liên hệ và ancillaries[] tùy chọn (xem bên trên); thêm Idempotency-Key. Bạn nhận được orderId, PNR của hãng bay, thời hạn xuất vé và trạng thái held. Trên sandbox, đơn được gửi tới hệ thống thử nghiệm của nhà cung cấp và không bị tính phí; trên production, tiền ký quỹ sẽ được tạm giữ.

Xuất vé

POST /v1/flights/orders/{orderId}/issue (bắt buộc Idempotency-Key) xuất vé điện tử và trả về số vé cho từng hành khách. Đọc đơn bất cứ lúc nào bằng GET /v1/flights/orders/{orderId}; trạng thái chuyển qua held → issued → cancelled/refunded.

Hủy vé (void), hủy và hoàn tiền

GET /v1/flights/orders/{orderId}/refund-quote cho biết một lượt hủy sẽ được hoàn lại bao nhiêu theo quy tắc giá vé (void trong ngày thường miễn phí). POST /v1/flights/orders/{orderId}/cancel thực hiện việc hủy; khoản hoàn tiền được ghi vào sổ cái ký quỹ của bạn, xem được trong cổng nhà phát triển.