接送服务响应中共用的数据结构,以及各自完整字段表所在位置。
当某个可选字段没有对应信息时会被省略,因此请以防御性的方式读取:字段缺失是正常情况,而不是错误。
每个端点页面都包含其返回结构的完整字段表。本页是一份索引。
各模型的文档位置
| 模型 | 完整字段表 |
|---|---|
| 报价、行程段、车辆、取消政策 | [搜索接送服务](/docs/transfers-search) |
| 设施 | [列出接送服务设施](/docs/transfers-amenities) |
| Money | [接送服务定价](/docs/transfers-pricing) |
| 预订与预订结构 | [预订接送服务](/docs/transfers-book) |
| 司机与已分配车辆 | [获取接送司机和车辆](/docs/transfers-reservation-vehicle) |
| 跟踪事件 | [获取最新接送跟踪事件](/docs/transfers-tracking-latest) |
| 退款结果 | [取消接送预订](/docs/transfers-cancel-reservation) |
Money
json
{
"amount": 181.97,
"currency": "USD"
}Location
地点信息出现在搜索元数据以及各行程段中。
json
{
"formattedAddress": "Barcelona Airport (BCN)",
"fullAddress": "08820 El Prat de Llobregat, Barcelona, Spain",
"iataCode": "BCN",
"icaoCode": "LEBL",
"placeId": "provider-place-id",
"latitude": 41.2974,
"longitude": 2.0833,
"timezone": "Europe/Madrid"
}设施
json
{
"key": "baby_seats",
"name": "Baby seats",
"description": "Your vehicle will have a child safety seat to keep children under age 4 safe.",
"imageUrl": "https://api.sandbox.travelandz.com/v1/assets/transfers/images/0/amenities/baby-seats.svg",
"pngImageUrl": "https://api.sandbox.travelandz.com/v1/assets/transfers/images/0/amenities/baby-seats.png",
"inputType": "numeric",
"included": false,
"selected": true,
"selectable": true
}included 表示该设施已包含在报价中;selectable 表示你可以加购;selected 在该设施成为已定价选择的一部分后出现。
标识符与令牌
searchId、resultId、reservationId 和 confirmationNumber 是稳定字符串,可以存储和记录。bookingToken 和 pricingToken 是不透明的:请原样传递,且不要写入客户端日志。