获取为我服务的司机
此接口获取用户进行中的订单,包括司未支付订单信息,合作方可限制同时进行中订单和未支付订单逻辑,可在用户进入app或者下单前调用,获取最新的进行中订单信息
若合作方储存历史订单数据,可查询自己数据源。
方法名
Uri |
请求方式 |
customer/info/drivers |
GET |
参数说明
参数 |
是否必须 |
说明 |
备注 |
token |
是 |
|
|
gpsType |
是 |
坐标类型 |
目前只支持 baidu |
返回值说明
值 |
说明 |
备注 |
code |
返回状态码 |
0成功、非0失败 |
message |
返回状态说明 |
|
data |
返回数据集合 |
|
next |
下次请求间隔时间 |
单位:秒 |
pollingState |
请求状态 |
0继续请求、1司机拒绝、2司机接单 |
pollingCount |
请求次数 |
|
drivers |
返回数据集合 |
|
bookingId |
预约id |
|
number |
预约人数 |
|
orders |
订单列表 |
|
orderId |
订单 ID |
|
orderStateCode |
订单状态码 |
101:派单中 201:派单中 301:已接单 302:已就位 303:已开车 304:代驾结束 403:用户取消 404:司机销单 501:司机报单 |
orderState |
订单状态说明 |
|
locationStart |
开始地点 |
|
locationEnd |
结束地点 |
|
payStatus |
支付状态 |
0 未支付, 1 已支付 |
cashOnly |
是否现金支付 |
0 否, 1 是 |
distance |
距离 |
该字段目前为1,无效 |
realtimeDistance |
距离 |
司机与用户的实时距离(单位:米,直线距离)如果是远程订单是规划的路径 |
driverId |
司机工号 |
|
role |
角色 |
组长、组员 |
isRemote |
是否是远程单 |
1是,0否 |
readyIntime |
是否及时就位(在就位后有效) |
1是,0否 |
readyDist |
远程单就位距离 |
|
subsidy |
远程单补贴 |
不带单位 |
fee |
远程单小费 |
不带单位 |
longitude |
司机的实时经纬度 |
需注意只有司机接单后才有值,否则为空字符串 |
latitude |
司机的实时经纬度 |
需注意只有司机接单后才有值,否则为空字符串 |
name |
姓名 |
|
phone |
司机电话 |
|
newLevel |
司机星级 |
1-5 |
pictureSmall |
司机图片 |
|
recommand |
是否皇冠 |
|
recommandBeginTime |
皇冠开始时间 |
皇冠拥有的开始时间 |
recommandEndTime |
皇冠结束时间 |
皇冠拥有的结束时间 |
serviceTimes |
服务次数 |
|
domicile |
籍贯 |
|
state |
司机状态 |
0在线、1接单中、2下线 |
year |
驾龄 |
|
goback |
是否返程 |
0不返城、1返城 |
waitTime |
等候时间 |
单位: 分钟,不带单位 |
idCard |
身份证 |
|
fake |
如果fake字段存在,订单不能被取消 |
|
bonusSn |
优惠劵号码 |
6.0.0+ |
bonusMoney |
优惠劵数额 |
6.0.0+ |
couponInfo |
代驾券信息 (不是列表,只是一个json对象) |
优惠券所有信息 |
activity909 |
909活动数据,如果不符合活动规则就没有此字段,非代驾客户端忽略 |
|
lng |
经度 |
(此经纬度为下单的起点经纬度 不会变) |
lat |
纬度 |
(此经纬度为下单的起点经纬度 不会变) |
注意事项
一般合作方重点关注drivers集合中orders集合判断进行中订单,onlinePayStatus=0(支付完成),1(待支付订单),2(用户申诉订单)
用户支持的支付渠道payChannel=0(用户在e代驾余额足够抵扣本次费用),1(现金支付),2(仅支付现金支付),3(在线支付)
成功返回值
{
"code": 0,
"data": {
"cancelFeeDetail": [
],
"bookingCancelFeeDetail": [
],
"drivers": [{
"bookingId": "9fc7ebb2307c3dec10da03cd1c61d5e2",
"matchId": "",
"bookingTime": "2019-05-23 22:37:43",
"createdTime": "2019-05-23 22:27:42",
"contactPhone": "18693194114",
"address": "安宁西路",
"locationEnd": "仁恒美林郡",
"bookingType": "01003",
"channel": "01003",
"source": "0",
"lat": "36.108901",
"lng": "103.728567",
"number": "1",
"orders": [{
"driverId": "lz96989",
"name": "文泾明",
"gender": "男",
"cityId": 34,
"year": 13,
"state": "0",
"domicile": "甘肃",
"newLevel": "5.00",
"recommand": 0,
"goback": "0",
"serviceTimes": "84",
"distance": "1米",
"longitude": "103.745344",
"latitude": "36.109366",
"pictureSmall": "https:\/\/edjpic.edaijia.cn\/drivericon\/2019\/05\/e7\/7d\/dc19a13804cdec4f3ca5081a2fac52d5.jpgSmall",
"dispatchOrderFilterDistance": 7000,
"serviceType": "00000000000000000000000000000001",
"phone": "18054172886",
"idcard": "6227221986******13",
"recommandBeginTime": 0,
"recommandEndTime": 0,
"orderId": "183204553",
"role": "组员",
"orderState": "已完成",
"orderStateCode": "501",
"bonusChange": true,
"locationStart": "安宁西路",
"locationEnd": "仁恒美林郡",
"payStatus": 0,
"cashOnly": 0,
"source": "0",
"channel": "01003",
"bonusSn": "",
"bonusMoney": 0,
"couponInfo": "{}",
"realtimeDistance": 1509,
"waitTime": "",
"fee": "",
"payChannel": 3,
"onlinePayStatus": "1",
"payFee": 70,
"isFromH5": true,
"orderAllStates": [{
"orderStateCode": "501",
"orderStateTimestamp": 1558624175,
"orderStateContent": "自动报单"
},
{
"orderStateCode": "304",
"orderStateTimestamp": 1558624171,
"orderStateContent": "到达目的地"
},
{
"orderStateCode": "303",
"orderStateTimestamp": 1558622590,
"orderStateContent": "开车行驶"
},
{
"orderStateCode": "302",
"orderStateTimestamp": 1558622451,
"orderStateContent": "司机已到达 等候0分"
},
{
"orderStateCode": "301",
"orderStateTimestamp": 1558621664,
"orderStateContent": "司机已接单"
}
],
"virtualPhone": 0
}],
"from": "01051617",
"cityId": "34",
"phone": "18693194114",
"calculator": [
],
"contactType": ""
}],
"bookings": [
],
"pollingState": 2,
"pollingCount": "1",
"next": 10,
"discountOrder": [
]
},
"message": "成功"
}