接送服务

接送服务概览

了解接送服务 API、响应约定和端点目录。

分享

了解接送服务 API、响应约定和端点目录。

基础路径

所有操作都位于 /v1/transfers 之下，并且需要 API 凭据。

text
text
https://api.sandbox.travelandz.com/v1/transfers

内容类型

任何带请求体的请求都要发送 Content-Type: application/json。流式端点需要 Accept: text/event-stream。

成功状态码

操作HTTP
查询200 OK
定价200 OK
预订与变更200 OK
取消200 OK
流连接已建立200 OK

创建预订返回 200 而不是 201。响应中带有 status 字段，因为请求返回时预订并不总是已确认。请参阅[预订接送服务](/docs/transfers-book)了解你必须处理的三种状态。

请求体或查询参数中的未知属性会以 400 拒绝。

端点目录

MethodPathPurpose
POST/v1/transfers/searchSearch transfer offers.
GET/v1/transfers/amenitiesList the amenity catalog.
POST/v1/transfers/pricingConfirm the final price of an offer.
POST/v1/transfers/bookCreate a reservation.
GET/v1/transfers/reservations/detailsRead a reservation by any identifier.
GET/v1/transfers/reservations/by-confirmation/:confirmationNumberRead a reservation by confirmation number.
GET/v1/transfers/reservations/by-search/:searchIdRead a reservation by search ID.
GET/v1/transfers/reservations/:reservationIdRead a single reservation.
POST/v1/transfers/reservations/changes/searchSearch replacement offers.
POST/v1/transfers/reservations/changesConfirm a reservation change.
POST/v1/transfers/flights/verifyCheck a flight against the pickup time.
GET/v1/transfers/flightsLook up a flight.
GET/v1/transfers/reservations/:reservationId/vehicleRead driver and vehicle.
GET/v1/transfers/reservations/:reservationId/vehicle/streamStream driver and vehicle.
GET/v1/transfers/tracking/:reservationId/events/latestRead the latest tracking event.
GET/v1/transfers/tracking/:reservationId/events/streamStream tracking events.
DELETE/v1/transfers/reservations/:reservationIdCancel a reservation.

集成检查清单

  1. 持久化 searchId、resultId、bookingToken、pricingToken、reservationId、confirmationNumber 以及你自己的 partnerTrackingId。
  2. 只收取 pricing 返回的 finalPrice.amount。
  3. 切勿依据搜索响应或设施数据自行重算价格。
  4. 将 409 transfer_price_changed 视为必须重新报价。
  5. 将 502 视为请求失败，并在再次创建前先查询预订。
  6. 含设施的预订请使用 searchId 查询。
  7. 对 429 和临时网络故障使用指数退避重试。
  8. 不再需要流连接时请显式关闭。
  9. 切勿在客户端记录令牌、支付数据或旅客个人信息。