行程摘要 API

有关访问行程摘要 API 的指南和示例

使用行程摘要 API,合作伙伴能够查询单个 Expedia 用户帐户预订的所有行程。

端点

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

必需的标头

Key:Expedia API 密钥
Authorization: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当前显示 100 个行程,共 216 个行程。搜索条件指定的结果超出预期。该消息将告知用户是否有任何结果未在响应中显示。

错误代码

常见错误代码

HTTP 状态代码错误代码错误响应原因
400INVALID_TRIP_START_DATE开始日期的格式无效,有效格式为 YYYY-MM-DD。输入的开始日期未采用规定的格式。
400INVALID_TRIP_END_DATE结束日期的格式无效,有效格式为 YYYY-MM-DD。输入的结束日期未采用规定的格式。
400START_DATE_LATER_THAN_END_DATE开始日期必须早于结束日期。开始日期应早于结束日期
400INVALID_TRIP_STATUS行程状态无效。必须为 [已预订/已取消/待处理/已保存]请使用上述值中的有效行程状态

API 详情

在这里,您可以查看此 API 的端点定义,然后转到 API Explorer 以试用所有 XAP 端点、下载 OpenAPI 规范或下载 Postman 集合。您可以使用其中一个或所有选项进行测试,从而了解示例和模式定义与实际输出的比较。


您觉得这个页面有用吗?
我们该如何改进这些内容?
感谢您帮助我们改进!