文档中心 > API类目 > 飞猪大交通顺风车api

alitrip.traffic.hitch.order.sync (顺风车业务订单数据同步接口)

顺风车业务订单数据同步接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
hit_create_order_request HitchOrderRequest 可选 创建订单入参
  • └ receive_order_time
  • Date
  • 可选
  • 2023-12-30 12:00:00
  • 司机接单时间,时间格式yyyy-MM-dd HH:mm
  • └ confirm_get_car_time
  • Date
  • 可选
  • 2023-12-30 12:00:00
  • 乘客上车时间,时间格式yyyy-MM-dd HH:mm
  • └ pay_time
  • Date
  • 可选
  • 2023-12-30 12:00:00
  • 支付时间 时间格式yyyy-MM-dd HH:mm
  • └ auth_token
  • String
  • 必须
  • xxxddddd
  • 用户授权token
  • └ arrival_destination_time
  • Date
  • 可选
  • 2023-12-30 12:00:00
  • 到达时间 时间格式yyyy-MM-dd HH:mm
  • └ agent_order_no
  • String
  • 必须
  • 29393833xd
  • 商家订单号
  • └ vehicle_model_name
  • String
  • 可选
  • 京A.1688
  • 车牌号
  • └ start_city_name
  • String
  • 必须
  • 北京市
  • 出发城市
  • └ driver_nick_name
  • String
  • 可选
  • 王师傅
  • 司机昵称
  • └ passenger_pro_pay_price
  • Number
  • 可选
  • 100
  • 乘客支付的价格,单位为分
  • └ agent_order_status
  • Number
  • 必须
  • 10
  • 订单状态
  • └ end_city_name
  • String
  • 必须
  • 天津市
  • 到达城市名称
  • └ ext_attribute
  • String
  • 可选
  • {}
  • 扩展属性,全部为json
  • └ plan_departure_time
  • Date
  • 可选
  • 2023-12-30 12:00:00
  • 乘客预计出发时间 时间格式yyyy-MM-dd HH:mm
  • └ mobile_phone
  • String
  • 必须
  • 186120303**
  • 用户手机号
  • └ publish_order_time
  • Date
  • 必须
  • 2023-12-30 12:00:00
  • 下单时间
  • └ start_position_name
  • String
  • 必须
  • 东大街2203
  • 出发站点名称
  • └ end_position_name
  • String
  • 必须
  • 北苑路北
  • 到达站点名称

响应参数

名称 类型 示例值 描述
biz_error_msg String 成功 返回信息
biz_error_code String error 错误码,成功时为空
biz_success Boolean true 接口业务是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTrafficHitchOrderSyncRequest req = new AlitripTrafficHitchOrderSyncRequest();
AlitripTrafficHitchOrderSyncRequest.HitchOrderRequest obj1 = new AlitripTrafficHitchOrderSyncRequest.HitchOrderRequest();
obj1.setReceiveOrderTime(StringUtils.parseDateTime("2023-12-30 12:00:00"));
obj1.setConfirmGetCarTime(StringUtils.parseDateTime("2023-12-30 12:00:00"));
obj1.setPayTime(StringUtils.parseDateTime("2023-12-30 12:00:00"));
obj1.setAuthToken("xxxddddd");
obj1.setArrivalDestinationTime(StringUtils.parseDateTime("2023-12-30 12:00:00"));
obj1.setAgentOrderNo("29393833xd");
obj1.setVehicleModelName("京A.1688");
obj1.setStartCityName("北京市");
obj1.setDriverNickName("王师傅");
obj1.setPassengerProPayPrice(100L);
obj1.setAgentOrderStatus(10L);
obj1.setEndCityName("天津市");
obj1.setExtAttribute("{}");
obj1.setPlanDepartureTime(StringUtils.parseDateTime("2023-12-30 12:00:00"));
obj1.setMobilePhone("186120303**");
obj1.setPublishOrderTime(StringUtils.parseDateTime("2023-12-30 12:00:00"));
obj1.setStartPositionName("东大街2203");
obj1.setEndPositionName("北苑路北");
req.setHitCreateOrderRequest(obj1);
AlitripTrafficHitchOrderSyncResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_traffic_hitch_order_sync_response>
    <biz_error_msg>成功</biz_error_msg>
    <biz_error_code>error</biz_error_code>
    <biz_success>true</biz_success>
</alitrip_traffic_hitch_order_sync_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

返回
顶部