请求行程
POST
/v1/orders功能: 根据起点、终点、运力类型,创建行程
支持运力: 所有,各车型接入均需申请
注: 默认为soso坐标系,坐标必须精确到小数点后6位,可以使用接口文档中的poi功能接口
拦截相关错误码:
录音授权拦截
{
"error":"code(62003)",
"error_detail":"请进行录音授权"
}
录音录像授权拦截
{
"error":"code(62004)",
"error_detail":"请进行录音、录像授权"
}
封禁拦截
{
"error":"code(62005)",
"error_detail":"封禁拦截"
}
请求参数
接入方订单id,必须提供,防止重复发单,每个用户(手机号)默认只能有一个进行中(即计费中)的行程
必须包含产品类型和运力类型
乘客相关数据,电话,姓名(可选),当前位置坐标(平台接入时可选)
经度(接入滴滴反作弊时必须)
纬度(接入滴滴反作弊时必须)
和imei必须至少提供一个
(可选,wifi/2G/3G/4G)
设备ip地址(接入滴滴反作弊时必须)
network为wifi时必填
network为wifi时必填
network为wifi时必填
用户选择的出行时间,默认为当前时间(即实时用车)。支持ISO8601格式和timestamp格式
可选,接入滴滴反作弊时必须) 用户请求接入方服务的时间,默认为当前时间,支持ISO8601格式和timestamp格式 2016-03-01T10:00:00+0800
费用预估id,有效时间2分钟用户使用滴滴非出租车服务必须先预估行程费用,此id在预估价格时下发,必须在请求行程时上传,用户请求行程时候的信息和预估时候的信息必须一致,出行时间与预估时候的时间误差不得大于5分钟
坐标系类型,默认soso,支持坐标系见备注
风控数据信息(接入滴滴反作弊时必须),若乘客已预支付,则在订单完成后将按预付费用与司机结算;否则,将等待接入方确认乘客支付后再付款给司机
[ 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地址
[ 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
第三方传入的标记字段,长度限制为64位(过长则截取),在查询或者回调行程信息时返回,不做任何修改
订单类别。 3 - 航班接机, 4 - 航班送机, 5 - 列车接站, 6 - 列车送站。 注:如果不能提供航班号/列车号和出发时间,本字段请勿赋值
航班/列车出发日期,Y-m-d:2016-08-30
支持按航班/列车的到达时间提交数据。0:traffic_date为出发时间,1:traffic_date为到达时间
{"add_price":1000},出租车发单额外信息
出租车调度费,单位为分,只支持100的倍数,最大为5000
{"amount":10000,"saving":2000,"coupon":2000},乘客支付的费用详情,计量单位必须是分。包括:总价、减免金额,券优惠金额,总价必须>=0,优惠减免金额必须<=总价。注:本字段仅对开放优惠权限的接入方有效
券优惠金额(滴滴优惠券)
支付类型:0线上支付(默认)1现金付 2预支付
版本号标记,1新版本会做安全相关验证,0老版本不做验证(默认)
{"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}}}