Itinerary Summary API

Itinerary Summary API にアクセスするためのガイダンスと例

Itinerary Summary API を使用すると、パートナーは、単一のエクスペディア ユーザーアカウントで予約されたすべての旅程に対してクエリを実行できます。

エンドポイント

メソッドエンドポイント
GEThttps://apim.expedia.com/bookings

必要なヘッダー

Key :エクスペディアの API キー
Authorization :エクスペディアの API 認証文字列
User-Id :username@domain.com
Accept :application/vnd.exp-booking.v3+json
Partner-Transaction-Id :パートナー トランザクション ID 文字列

オプションのヘッダー

パスワード :[エクスペディアアカウントのパスワード] エクスペディアのユーザーアカウントで予約する場合に入力します。ゲストユーザーとして予約する場合は空白のままにしてください。

次のステップ

  • ユーザーはエクスペディアのウェブサイトにリンクして旅程を表示できます
  • ユーザーはオプションの API クエリを使用して旅程データにアクセスできます。

Itinerary Summary API クエリの例

リクエスト URL

https://apim.expedia.com/bookings?status=BOOKED,SAVED&startDate=2021-06-01&endDate=2021-06-02&limit=10

レスポンス

{
	"Warnings": [{
		"MAX_LIMIT_EXCEEDED": "The maximum number of itineraries that can be retrieved exceeded. Allowed Limit: 100."
	}],
	"TransactionId": "f06edfa3-27f4-44e6-838c-b8dd3d0a3210",
	"Itineraries": [{
			"Title": "Hotel & Air Package",
			"TripNumber": "1234567866",
			"CreateDateTime": "2021-06-17T02:51:33.320Z",
			"Entities": [{
					"ProductType": "HOTEL",
					"BookingStatus": "BOOKED",
					"StartDateTime": "2021-06-23T08:00:00-08:00",
					"EndDateTime": "2021-06-26T08:00:00-08:00"
				},
				{
					"ProductType": "FLIGHT",
					"BookingStatus": "BOOKED",
					"StartDateTime": "2021-06-08T22:00:00-08:00",
					"EndDateTime": "2021-06-10T22:00:00-08:00"
				}
			],
			"Links": {
				"WebItinRetrieve": {
					"Href": "https://www.expedia.com/1234567"
				},
				"ApiItinRetrieve": {
					"Accept": "application/vnd.exp-booking.v3+json",
					"Method": "GET",
					"Href": "https://apim.expedia.com/packages/bookings/71184721958"
				}
			},
			"TotalCommission": {
				"Value": "68.80",
				"Currency": "USD"
			}
		},
		{
			"Title": "Hotel Booking",
			"TripNumber": "1234567866",
			"CreateDateTime": "2021-06-17T08:00:00-08:00",
			"Entities": [{
				"ProductType": "HOTEL",
				"BookingStatus": "BOOKED",
				"StartDateTime": "2021-06-23T08:00:00-08:00",
				"EndDateTime": "2021-06-26T08:00:00-08:00"
			}],
			"Links": {
				"WebItinRetrieve": {
					"Href": "https://www.expedia.com/1234567"
				},
				"ApiItinRetrieve": {
					"Accept": "application/vnd.exp-booking.v3+json",
					"Method": "GET",
					"Href": "https://apim.expedia.com/hotels/bookings/71184721958"
				}
			}
		},
		{
			"Title": "Car Booking",
			"TripNumber": "1234567866",
			"CreateDateTime": "2021-06-17T08:00:00-08:00",
			"Entities": [{
				"ProductType": "CAR",
				"BookingStatus": "BOOKED",
				"StartDateTime": "2021-06-09T08:00:00-08:00",
				"EndDateTime": "2021-06-10T08:00:00-08:00"
			}],
			"Links": {
				"WebItinRetrieve": {
					"Href": "https://www.expedia.com/1234567"
				},
				"ApiItinRetrieve": {
					"Accept": "application/vnd.exp-booking.v3+json",
					"Method": "GET",
					"Href": "https://apim.expedia.com/cars/bookings/71184721958"
				}
			}
		},
		{
			"Title": "Air Booking",
			"TripNumber": "1234567866",
			"CreateDateTime": "2021-06-17T08:00:00-08:00",
			"Entities": [{
				"ProductType": "FLIGHT",
				"BookingStatus": "BOOKED",
				"StartDateTime": "2021-06-08T08:00:00-08:00",
				"EndDateTime": "2021-06-10T08:00:00-08:00"
			}],
			"Links": {
				"WebItinRetrieve": {
					"Href": "https://www.expedia.com/1234567"
				},
				"ApiItinRetrieve": {
					"Accept": "application/vnd.exp-booking.v3+json",
					"Method": "GET",
					"Href": "https://apim.expedia.com/airs/bookings/71184721958"
				}
			}
		}
	]
}

警告コード

一般的な警告コード

警告コード警告レスポンス原因
MAX_LIMIT_EXCEEDED取得できる旅程の最大数を超えました。上限 : 100。旅程の数が、システムで取得できる旅程の最大数を超えました。結果を絞り込んでください。
INVALID_TRIP_LIMIT旅行の制限値が無効です。指定できる値は [1 ~ 100] の範囲の数値です。URL パラメーター「Limit」の値が有効なタイプではありませんでした。前述の範囲内の有効な数値である必要があります。結果はシステム制限に基づいて取得されます
PARTIAL_RESULTS_DISPLAYED216 件中 100 件の旅程を表示しています。この検索条件では、想定よりも多くの結果が得られました。このメッセージは、レスポンスに表示されていない結果の有無をユーザーに知らせるものです。

エラーコード

一般的なエラーコード

HTTP ステータスコードエラーコードエラーレスポンス原因
400INVALID_TRIP_START_DATE開始日の形式が無効です。有効な形式は YYYY-MM-DD です。入力された開始日が、定義された形式ではありませんでした。
400INVALID_TRIP_END_DATE終了日の形式が無効です。有効な形式は YYYY-MM-DD です。入力された終了日が、定義された形式ではありませんでした。
400START_DATE_LATER_THAN_END_DATE開始日は終了日より前である必要があります。開始日は終了日より前にする必要があります
400INVALID_TRIP_STATUS旅行ステータスが無効です。[BOOKED / CANCELED / PENDING / SAVED] でなければなりません前述の値からいずれかの有効な旅行ステータスを使用してください

API の詳細

ここでは、この API のエンドポイント定義を調べてから、API Explorer に移動してすべての XAP エンドポイントを試したり、OpenAPI 仕様をダウンロードしたり、Postman コレクションをダウンロードしたりできます。これらのオプションの 1 つまたはすべてを使用してテストすることで、サンプルとスキーマ定義が実際の出力とどのように違うかを理解できます。


このページは役に立ちましたか ?
このコンテンツに改善が必要な点があれば、
サービス向上にご協力いただきありがとうございます。