请求行程

功能: 根据起点、终点、运力类型,创建行程

支持运力: 所有,各车型接入均需申请

资源URL

POST: v1/orders

请求参数:

参数名 类型 说明
oid string 接入方订单id,必须提供,防止重复发单,每个用户(手机号)默认只能有一个进行中(即计费中)的行程
remark string(可选) 第三方传入的标记字段,长度限制为64位(过长则截取),在查询或者回调行程信息时返回,不做任何修改
product json 必须包含产品类型和运力类型
{"product_type":"private-car","ride_type":"compact"}
product_type 产品类型
ride_type 运力类型
passenger json 乘客相关数据,电话,姓名(可选),当前位置坐标(平台接入时可选)
{"phone":"13900000000","name":"张三","lng":116.312615,"lat":40.058922}
phone 手机号
name(可选) 姓名
lng(平台可选) 经度(接入滴滴反作弊时必须)
lat(平台可选) 纬度(接入滴滴反作弊时必须)
user json 叫车人信息,如果平台无法提供用户的设备信息,则在滴滴审核通过之后,可以使用叫车人在第三方平台的个人信息
{"user_id":"123456789","name":"张三","phone":"13900000001","openid":"2088902330753740"}
user_id 用户在第三方平台的id
phone(可选) 电话(与乘车人相同时可选)
name(可选) 姓名(可选)
openid(可选) 真身id
type(可选) openid类型。1:支付宝(默认),2:百度;
若需开通支付宝真身未支付订单校验功能,则必传。开通此功能需要提前申请权限。其他真身id类型支持开发中
origin json 用车出发地信息
{"lng":116.312615,"lat":40.058922,"name":"西二旗地铁站","address":"上地十街"}
lng 经度
lat 纬度
name 地名
address(可选) 地址
destination json类型 用车目的地信息
{"lng":116.344434,"lat":39.998568,"name":"五道口购物中心","address":"成府路"}
lng 经度
lat 纬度
name 地名
address(可选) 地址
device json 设备信息
{"imei":"123we125","suuid":"123juuiuiausd","network":"WIFI","wifi_name":"tp_link123","wifi_ip":"10.10.10.10","wifi_mac":"aasdasd"}
imei/suuid 必须至少提供一个
deviceid(可选) 设备id
network(可选,wifi/2G/3G/4G)
ip 设备ip地址(接入滴滴反作弊时必须)
wifi_name(可选) network为wifi时必填
wifi_ip(可选) network为wifi时必填
wif_mac(可选) network为wifi时必填
create_time string(可选,接入滴滴反作弊时必须) 用户请求接入方服务的时间,默认为当前时间,支持ISO8601格式和timestamp格式
2016-03-01T10:00:00+0800
departure_time string(可选) 用户选择的出行时间,默认为当前时间(即实时用车)。支持ISO8601格式和timestamp格式
2016-03-01T10:00:00+0800
estimate_id string(taxi 无需提供) 费用预估id,有效时间2分钟用户使用滴滴非出租车服务必须先预估行程费用,此id在预估价格时下发,必须在请求行程时上传,用户请求行程时候的信息和预估时候的信息必须一致,出行时间与预估时候的时间误差不得大于5分钟
map_type string(可选) 坐标系类型,默认soso,支持坐标系见备注
o_type int(可选) 订单类别。
3 - 航班接机,
4 - 航班送机,
5 - 列车接站,
6 - 列车送站。
注:如果不能提供航班号/列车号和出发时间,本字段请勿赋值
traffic_no string(o_type > 0 必需) 航班号/列车号
traffic_date string(o_type > 0 必需) 航班/列车出发日期,Y-m-d:2016-08-30
date_type int(可选) 支持按航班/列车的到达时间提交数据。0:traffic_date为出发时间,1:traffic_date为到达时间
taxi_info json(可选) {"add_price":1000},出租车发单额外信息
add_price(可选) 出租车调度费,单位为分,只支持100的倍数,最大为5000
price json(可选) {"amount":10000,"saving":2000,"coupon":2000},乘客支付的费用详情,计量单位必须是分。包括:总价、减免金额,券优惠金额,总价必须>=0,优惠减免金额必须<=总价。注:本字段仅对开放优惠权限的接入方有效
amount(必需) 总价
coupon(可选) 券优惠金额(滴滴优惠券)
saving(可选) 减免金额
risk_info json(可选) 风控数据信息(接入滴滴反作弊时必须),若乘客已预支付,则在订单完成后将按预付费用与司机结算;否则,将等待接入方确认乘客支付后再付款给司机
pay_info:json类型 [ pay_type, time, lat, lng, imei/deviceid, ip, wifi_mac ]。pay_type:支付方式,空值表示未支付,取值范围:baidu(百度钱包),alipay(支付宝),wechat(微信),qq(qq钱包),debitcard(借记卡),creditcard(信用卡);time:支付时间;lat,lng:支付时用户经纬度信息;deviceid/imei:支付设备id或imei,必须至少提供一个;ip:支付ip;wifi_mac:支付网络的wifi mac地址
card_info:json类型 [ card_id, people_id, time, ip, imei, deviceid, lat, lng, status, channel, source, wifi_mac]。用户绑卡信息。card_id:用户绑定的银行卡号(可加密),people_id:身份证号(可加密),time:绑卡时间,ip:绑卡ip,imei:绑卡设备imei,deviceid:绑卡设备id,imei/deviceid必须至少提供一个,lat,lng:绑卡经纬度信息,status:绑卡结果(1成功,0失败),channel:绑卡渠道,baidu(百度钱包),alipay(支付宝),wechat(微信),qq,debitcard(借记卡),creditcard(信用卡),source:绑卡端,web,webapp,app等,wifi_mac:绑卡网络的wifi mac地址
login_info:json类型 [ time, ip, lat, lng, wifi_mac, imei, deviceid, source, passid ]。最近一次登陆信息,time:登陆时间,ip:登陆ip,imei:登陆设备imei,deviceid:登录设备id,imei/deviceid必须至少提供一个,source:登录端,web,webapp,app等,lat,lng:登陆坐标位置信息,wifi_mac:登陆网络的wifi mac地址,passid:登录passid
pay_type int(可选) 支付类型:0线上支付(默认)1现金付 2预支付
new_version int(可选) 版本号标记,1新版本会做安全相关验证,0老版本不做验证(默认)

注: 默认为soso坐标系,坐标必须精确到小数点后6位,可以使用接口文档中的poi功能接口

请求示例:

curl -X POST 
-H 'Authorization: Bearer domain|{access_token}' 
-H "Content-Type: application/json" 
'https://api.xiaojukeji.com/v1/orders' 
-d '{"oid":"1234567890",product":{"product_type":"private-car","ride_type":"compact"},"origin":{"lng":116.312615,"lat":40.058922,"name":"西二旗地铁站","address":"上地十街"},"destination":{"lng":116.344434,"lat":39.998568,"name":"五道口购物中心","address":"成府路"},"passenger":{"phone":"13900000000","name":"Will","lng":116.312615,"lat":40.058922},"device":{"time":"2016-03-01T10:00:00+0800","imei":"123aswdwe1235","suuid":"123juuiuiausd"},"departure_time":"2016-03-01T10:00:00+0800","create_time":"2016-03-01T10:00:00+0800","estimate_id":"asdasdasdad","map_type":"wgs","risk_info":{"pay_type":"baidu","time":"2016-03-01T10:00:00+0800","lng":116.344434,"lat":39.998568,"deviceid":"asdfkwhfmd","ip":"127.0.0.1","wifi_mac":"asdqweert"},"card_info":{"card_id":"1234567890","people_id":"123asdqwe","ip":"127.0.0.1","wifi_mac":"asdqweert","imei":"qweasdrt123","deviceid":"qweasdrt123","status":"1","channel":"baidu","source":"webapp","time":"2016-03-01T10:00:00+0800","lng":116.344434,"lat":39.998568},"login_info":{"ip":"127.0.0.1","imei":"qweasdrt123","deviceid":"qweasdrt123","wifi_mac":"asdqweert","time":"2016-03-01T10:00:00+0800","lng":116.344434,"lat":39.998568}}}'

成功返回参数说明:

参数名 类型 说明
oid string 第三方订单id
didi_oid string 滴滴订单id
status string 行程状态(见备注
product_type string 产品类型
ride_type string 运力类型

返回示例:

成功:http status 200

{
  "oid": "123123123",
  "didi_oid": "didi_oid",
  "status": "Pending",
  "product_type": "private-car",
  "ride_type": "compact"
}

拦截相关错误码:

录音授权拦截

{
    "error":"code(62003)",
    "error_detail":"请进行录音授权"
}

录音录像授权拦截

{
    "error":"code(62004)",
    "error_detail":"请进行录音、录像授权"
}

封禁拦截

{
    "error":"code(62005)",
    "error_detail":"封禁拦截"
}

results matching ""

    No results matching ""