文档中心 > API类目 > 旅行用车API

taobao.alitrip.car.driver.status.update (司机服务状态更新接口)

飞猪用车业务回调接口,用于服务商实时回传更新司机当前服务状态

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_id String 必须 1987834718488585498 飞猪订单id
third_order_id String 可选 1111 服务商订单id
provider_id String 必须 20010 服务商标识,由飞猪提供给到各服务商
status Number 必须 1 司机服务状态。1-司机已出发,2-司机已到达,3-司机已开始服务
time String 必须 yyyy-mm-dd hh:mm:ss 状态变更相应时间(如司机出发时间、司机到达时间、服务开始时间),格式:yyyy-mm-dd hh:mm:ss
seller_id String 可选 1233 可选,卖家id
use_type Number 可选 1 0:接送机 1:实时打车 2:租车(不传值默认为0)

响应参数

名称 类型 示例值 描述
message_code Number -1 错误码
message String 订单号不存在 错误信息
data Json 其它数据,预留,暂不使用 其它数据,预留,暂不使用

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripCarDriverStatusUpdateRequest req = new AlitripCarDriverStatusUpdateRequest();
req.setOrderId("1987834718488585498");
req.setThirdOrderId("1111");
req.setProviderId("20010");
req.setStatus(1L);
req.setTime("yyyy-mm-dd hh:mm:ss");
req.setSellerId("1233");
req.setUseType(1L);
AlitripCarDriverStatusUpdateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_car_driver_status_update_response>
    <message_code>-1</message_code>
    <message>订单号不存在</message>
    <data>其它数据,预留,暂不使用</data>
</alitrip_car_driver_status_update_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部