行程摘要 API

存取行程摘要 API 的指導和範例

行程摘要 API 可以讓合作夥伴查詢單一個 Expedia 使用者帳戶曾預訂的所有行程。

端點

方法端點
GEThttps://apim.expedia.com/bookings

需要的標頭

金鑰:Expedia API 金鑰
授權:Expedia API 授權字串
User-Id:username@domain.com
Accept:application/vnd.exp-booking.v3+json
Partner-Transaction-Id:合作夥伴交易 ID 字串

選擇性標頭

密碼:[Expedia 智遊網帳戶密碼] 如果使用 Expedia 使用者帳戶預訂,則內含密碼。留空以使用訪客身分預訂。

後續步驟

  • 使用者可以連結到 Expedia 查看行程
  • 使用者可以使用可選的 API 查詢來存取行程資料。

行程摘要 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] 範圍內的數字。「Limit」的 URL 參數值不是有效的類型。它必須是上述範圍內的有效數字。將根據系統限制取得結果
PARTIAL_RESULTS_DISPLAYED顯示 216 個行程中的 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 集合。使用其中一個或所有這些選項進行測試。會有助您了解這些範例和結構描述定義與實際輸出間的差異。


這個頁面有幫助嗎?
我們能如何改善內容?
感謝您協助我們進行改善!