アイテムREST API v2(レガシー)を注文してください
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
!重要このREST APIの新しいバージョン(v2.1)が利用可能です。このREST APIが初めてなら、新しいバージョンを使いましょう。あるいは、すでに古いバージョンを使っているなら、v2とv2.1の違いについて調 べてアップグレードしてみてください。
orderItemsオブジェクトは注文の一部として購入されたものを表しています。航空会社の予約の場合、注文項目は通常、1つ以上のフライト区間、またはフライトに加えて追加で購入される付随項目(超過手荷物許可や優先搭乗など)です。
以下の表は注文品の属性を説明します:
属性
種類
概要
例
type
文字列 enum(複数語の場合は大文字にアンダースコア付き)
注文品の種類。
以下のいずれかでなければなりません:
"FLIGHT", "HOTEL", "CAR", "BAG", "INSURANCE", "CAR_SEAT", "MEAL", "FEE", "LOUNGE_ACCESS", "HOTEL_WIFI", "HOTEL_BREAKFAST", "SEAT_UPGRADE", "TAXI", "PARKING", "SEAT", "UPGRADE", "TRANSPORT", "OTHER", "INFLIGHT_ENTERTAINMENT", "ACTIVITY", "CARBON_OFFSET", "PAID_SUBSCRIPTION", "COMFORT_PACK", "INFLIGHT_VOUCHER", "PACKAGE", "SMS_ITINERARY", "SPECIAL_ASSISTANCE", "CHARITY_DONATION", "TRANSFER" *Deprecated:"BAGGAGE", "FEES", "SEAT_UPGRADES", "INFLIGHT_VOUCHERS"
productId
ストリング
商品のID。
"DUB-LAS"
quantity
番号
注文品の数や数量。
2
orderedAt
ISO 8601 日付/時刻 UTC
注文品が作られた日付と時間。
"2026-01-01T16:17
.000Z"price
数字(通貨)
注文品の会社価格。
50, 30.6, -45
currencyCode
3文字 ISO 4217
注文品目の組織の通貨コード。
"EUR", "NZD", "USD"
originalPrice
数字(通貨)
組織の通貨に換算される前の注文品目の単価。
50
originalCurrencyCode
3文字 ISO 4217
注文品の元の通貨コード。
"EUR", "NZD", "USD"
referenceId
ストリング
クライアントが注文品を参照するために生成するIDです。
"B94TXY-1"
vendor
ストリング(タイトルケース推奨)
注文品を販売している組織です。
"Company ABC"
status
文字列(大文字)
注文品の状況。
"RESERVED", "PENDING", "DECLINED", "CONFIRMED", "CANCELLED", "REFUNDED", "PURCHASED", "UNKNOWN"
channel
文字列(大文字)
注文で使用されたチャネル。
"AIRPORT_KIOSK", "BRANCH", "CALL_CENTER", "GDS", "KIOSK", "MOBILE_APP", "MOBILE_WEB", "OFFLINE", "OTA", "OTHER", "WEB"
language
2文字のISO 639言語コード(大文字)
注文を出す際に使われる言葉遣い。
"EN", "FR", "DE"
name
ストリング(タイトルケース推奨)
注文品の名前。注文品名のフリーテキスト値。最大制限
"Insurance"
description
ストリング(タイトルケース推奨)
注文品の説明。
"Family Insurance"
flightSegments
JSON JSONオブジェクトの配列
注文品に関連するフライトセグメントの一覧。フライトオーダーのみに該当します。
該当なし
フライトセグメントの属性:
属性
概要
種類
例
必須/任意
id
フライトセグメントを識別するためのID。
ストリング
"1234"
必須
origin
フライトセグメントのIATA空港または都市の出発地コード。
IATA空港または市コード(大文字)
"DUB", "LHR", "BCN"
必須
destination
フライトセグメントのIATA空港または都市の目的地コード。
IATA空港または市コード(大文字)
"DUB", "LHR", "BCN"
必須
departureDateTime
フライト区間の現地出発日時。この値は現地の出発日時として入力し、最後にZを付ける必要があります。UTC時間でなくてもです。
ISO 8601 日付/時刻
"2026-08-23T16
"必須
arrivalDateTime
フライト区間の現地到着日時。この値は現地の出発日時として入力し、最後にZを付ける必要があります。UTC時間でなくてもです。
ISO 8601 日付/時刻
"2026-08-23T16
"必須
flightNumber
フライトセグメントのマーケティングフライト番号です。
ストリング
"12345"
必須
fareClass
フライト区間の運賃クラス。
ストリング(タイトルケース推奨)
"Economy", "Business", "First Class"
必須
fareFamily
フライトセグメントの運賃ファミリー。
ストリング(タイトルケース推奨)
"Economy Plus"
オプション
bookingClass
フライトセグメントの予約クラス。
文字列(大文字)
"Y7 K5 M4 T6 E3"
オプション
equipmentType
フライトセグメントの装備タイプ。
文字列(大文字)
"BOEING 777"
オプション
carrier
フライトセグメントのマーケティングキャリアコードです。
IATA航空会社コード(大文字)
"EI", "FR", "BA"
必須
originDestination
フライトセグメントの出発地と目的地。
文字列(大文字)
"DUB-JFK"
オプション
operatingCarrier
フライトセグメントの運航キャリアコード。
IATA航空会社コード(大文字)
"EI", "FR", "BA"
オプション
operatingCarrierFlightNumber
フライトセグメントの運航航空会社便番号。
ストリング
"5678"
オプション