请求行程
功能: 根据起点、终点、运力类型,创建行程
支持运力: 所有,各车型接入均需申请
资源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":"封禁拦截"
}