航空券API

運賃カレンダー

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 は、その路線の日別の最安キャッシュ運賃を、お客様の通貨とキャッシュの鮮度とともに返します。returnFrom / returnTo を追加すると日付の組み合わせごとの往復合計が、cabin を追加するとクラスを絞り込めます。当社の価格キャッシュから即座に返され、サプライヤー検索としてカウントされることもないため、実際の検索の前にカレンダーや「最安日」の帯を表示するのに使ってください。

検索

POST /v1/flights/search に、片道なら1つ、往復なら2つ、周遊なら最大6つのスライスを指定し、タイプ別の搭乗者数、任意でキャビンと最大経由回数（maxStops）を指定します。wait=true の場合、すべてのサプライヤーが応答した時点で全オファーを含むレスポンスが返ります。wait=false の場合は searchId が返されるので、complete が true になるまでカーソル付きで GET /v1/flights/search/{searchId} をポーリングします。

各オファーには、不透明な offerId、搭乗者ごとの内訳付きのお客様の通貨での合計、スライス → セグメント（航空会社、便名、時刻、機材、キャビン、手荷物）、運賃条件の概要、有効期限が含まれます。オファーは検索セッションの間（約20分）有効です。

価格と規則

POST /v1/flights/offers/{offerId}/price は、確定の直前にサプライヤーで運賃を再検証し、確定価格、税金、航空会社が求める搭乗者項目（渡航書類、生年月日、マイレージ会員情報）を返します。GET .../fare-rules はペナルティの条文を、GET .../ancillaries はオーダーに追加できる有料手荷物とオプションの一覧を返します。

付帯サービス（追加手荷物）

GET /v1/flights/offers/{offerId}/ancillaries は、その運賃で航空会社が提供する有料オプションを一覧表示します。現在は追加の受託手荷物枠で、それぞれに key、個数 / 重量、搭乗者1人あたりの価格があります。有料とは、オファー自体に表示される無料手荷物枠とは異なり、運賃に上乗せして価格が付けられ、オーダーとともに請求されることを意味します。

購入するには、POST /v1/flights/orders に ancillaries[] を追加します。オプションごとに1エントリで、key と passengerIndex（passengers 内の0始まりのインデックス）を指定します。オーダーとともに価格確定・予約・発券され、オーダーの航空券合計に反映されます。発券済みのオーダーにはオプションを追加できません。座席指定も同じ方式で提供予定です。

{
  "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 }]
}

オーダーを作成する

POST /v1/flights/orders に、offerId、搭乗者（パスポートどおりの氏名、タイプ、生年月日、国際線の旅程では渡航書類）、連絡先、任意の ancillaries[]（上記参照）を指定し、Idempotency-Key を付与します。orderId、航空会社のPNR、発券期限、ステータス held が返されます。サンドボックスではオーダーはサプライヤーのテストシステムに登録され、課金は発生しません。本番ではデポジットが確保されます。

発券する

POST /v1/flights/orders/{orderId}/issue（Idempotency-Key 必須）はeチケットを発券し、搭乗者ごとの航空券番号を返します。オーダーは GET /v1/flights/orders/{orderId} でいつでも取得できます。ステータスは held → issued → cancelled/refunded と推移します。

ボイド、キャンセル、払い戻し

GET /v1/flights/orders/{orderId}/refund-quote は、運賃規則に基づいてキャンセル時に返金される額を示します（当日中のボイドは通常無料です）。POST /v1/flights/orders/{orderId}/cancel で確定します。払い戻しはデポジットの取引台帳に計上され、開発者ポータルで確認できます。