API 参考

旅游 API v1 的所有端点，按产品分组。每个页面都展示参数、请求与响应结构、四种语言的示例代码以及在线调试工具。

身份验证

post/v1/oauth/tokenExchange your key id + secret for a short-lived bearer token. Send it as `Authorization: Bearer …` together with `X-API-Key: {client_id}` on every call.

账户

get/v1/accountWho am I — the partner behind the presented credential.

机票

get/v1/flights/price-calendarCheapest fare per day for a route over a date window, from our price cache — instant and never a live supplier call. Draw a fare calendar before searching. Omit the return window for one-way prices.
post/v1/flights/searchSearch flights. Returns a session to poll, or the complete result when `wait` is true.
get/v1/flights/search/{searchId}Read the next page of a running search. `status` becomes `complete` when every supplier answered.
post/v1/flights/offers/{offerId}/priceRe-price an offer right before booking. `priceChanged` tells you the total moved.
get/v1/flights/offers/{offerId}/fare-rulesFare rules and conditions of an offer.
get/v1/flights/offers/{offerId}/ancillariesChargeable extras available for an offer — today extra checked-baggage allowances, priced by the airline per passenger. Add them to the order via `ancillaries[]` on POST /v1/flights/orders.
post/v1/flights/ordersCreate an order (hold) from an offer. Requires an `Idempotency-Key` header.
get/v1/flights/orders/{orderId}Read an order: status, time limit, tickets.
post/v1/flights/orders/{orderId}/issueIssue the tickets of a held order (charges your deposit balance).
get/v1/flights/orders/{orderId}/refund-quoteWhat a cancellation would refund, before you commit.
post/v1/flights/orders/{orderId}/cancelCancel: a held order is released; a ticketed order is voided inside the void window, else refunded.
get/v1/flights/scheduleTimetable for a route on one day: which flights operate, with local times and equipment — no fares. Query: `origin`, `destination` (IATA), `date` (yyyy-MM-dd).
post/v1/flights/orders/{orderId}/exchange/searchExchange step 1: search replacement itineraries for a ticketed order. Offers come back in the search shape and expire the same way.
post/v1/flights/orders/{orderId}/exchange/quoteExchange step 2: what exchanging the listed tickets onto an offer would cost. No side effects.
post/v1/flights/orders/{orderId}/exchangeExchange step 3: re-issue the listed tickets onto the offer (charges your deposit balance). Requires an `Idempotency-Key` header.

酒店

内容