行程详情
功能: 根据行程ID返回行程详情,包括行程状态,司机的信息,车辆信息等。
支持运力: 所有
资源URL
GET: v1/orders/{didi_oid}/detail
注: 坐标信息默认不提供,如需该信息,请单独提交申请
请求参数:
参数名 | 类型 | 说明 |
---|---|---|
didi_oid | string | 行程ID |
curl -X GET
-H "Content-Type: application/x-www-form-urlencoded"
-H "Authorization: Bearer domain|{access_token}"
"https://api.xiaojukeji.com/v1/orders/{didi_oid}/detail"
返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
oid | string | 第三方订单id |
didi_oid | string | 滴滴订单id |
request_time | DATE_ISO8601时间格式 | 约车时间 |
product_type | string | 产品类型 |
ride_type | string | 运力类型 |
status | string | 行程状态(见备注) |
is_pay | int | 行程是否已支付。 0:未支付 1:已支付 |
passenger_phone | string | 乘客联系电话 |
passenger_name | string | 乘客姓名(如发单时有提供) |
map_type | string | 坐标系类型,默认soso |
remark | string | 发单时上传的标记信息,不做任何修改 |
pay_type | int | 支付类型 0:线上支付(默认) 1:现金付 |
origin | json | 出发地信息 |
name | 出发地名称 | |
lat | 出发地纬度 | |
lng | 出发地经度 | |
destination | json | 目的地信息 |
name(string) | 目的地名称 | |
lat(float) | 目的地纬度 | |
lng(float) | 目的地经度 | |
driver | json | 司机信息 |
phone_number(string) | 加密的司机手机号,可以通过解密接口获取解密后手机号(需授权) | |
rating(float) | 司机星级 | |
driver_id(string) | 司机id | |
picture_url(string) | 司机头像 | |
name(string) | 司机称谓 | |
vehicle | json | 车辆信息 |
car_type | 车辆型号 | |
license_plate | 车牌号 | |
picture_url | 车辆图片,为空表示图片未收录 | |
car_color | 车辆颜色 | |
process | json | 状态流转信息 |
status | 状态 | |
time | 状态改变的时间,DATE_ISO8601格式 | |
price | json | 行程总费用,只在行程结束时返回 |
currency | 货币种类 | |
amount | 金额,单位:分 | |
total_time | 总时长,单位:秒 | |
total_distance | 总里程,单位:米 | |
type | 费用类型 | |
description | 费用描述,英文 | |
description_cn | 费用描述,中文 | |
charges | json | 费用详情 |
currency | 货币种类 | |
amount | 金额,单位:分 | |
type | 费用类型 | |
description | 费用描述,英文 | |
description_cn | 费用描述,中文 | |
pay_status | json | 支付详情 |
is_pay | 行程是否已支付。 0:未支付 1:已支付 |
|
permit | 订单是否可支付状态。 0:不可支付 1:可支付 |
|
type | 支付类型 0:线上支付(默认) 1:现金支付 |
|
share_info | json | 分享详情 |
share_url | 分享短链 | |
share_url_origin | 原始链接 | |
share_content | 分享内容 | |
share_title | 分享标题 | |
share_picture | 分享缩略图 |
返回示例:
成功:http status 200
失败:http status 非200
{
"request_time": "2018-06-27T10:00:19+0800",
"departure_time": "2018-06-27T10:00:19+0800",
"product_type": "private-car",
"ride_type": "compact",
"status": "Finished",
"passenger_phone": "13900000000",
"origin": {
"name": "五道口购物中心",
"lat": "39.988169",
"lng": "116.340709"
},
"destination": {
"name": "尚东数字山谷",
"lat": "40.042655",
"lng": "116.290943"
},
"driver": {
"phone_number": "1F268444DE3649B366B589|1",
"rating": 5,
"level": 5,
"cnt_order": 919,
"company": "",
"driver_id": "3305630fec7bf387520a1312e9d24406",
"picture_url": "",
"name": "曾师傅",
"car_color": "",
"lat": "40.042655",
"lng": "116.290943"
},
"vehicle": {
"car_type": "特斯拉Model S",
"license_plate": "京**7755",
"picture_url": "",
"car_color": "黑"
},
"map_type": "soso",
"process": [
{
"status": "Pending",
"time": "2018-06-27T10:00:19+0800"
},
{
"status": "Accepted",
"time": "2018-06-27T10:00:27+0800"
},
{
"status": "Arrived",
"time": "2018-06-27T10:02:27+0800"
},
{
"status": "Charging",
"time": "2018-06-27T10:02:33+0800"
},
{
"status": "Finished",
"time": "2018-06-27T10:05:52+0800"
},
{
"status": "Paid",
"time": "2018-06-27T10:06:57+0800"
}
],
"price": {
"currency": "CNY",
"amount": 16598,
"total_time": 2940,
"total_distance": 50900,
"type": "totalFee",
"description": "total fee",
"description_cn": "总费用"
},
"charges": [
{
"currency": "CNY",
"amount": 800,
"type": "startPrice",
"description": "starting price",
"description_cn": "起步价"
},
{
"currency": "CNY",
"amount": 8228,
"type": "drivingFee",
"description": "driving fee",
"description_cn": "里程费"
},
{
"currency": "CNY",
"amount": 3950,
"type": "emptyFee",
"description": "empty driving fee",
"description_cn": "远途费"
},
{
"currency": "CNY",
"amount": 1900,
"type": "highwayFee",
"description": "highway tolls",
"description_cn": "高速费"
},
{
"currency": "CNY",
"amount": 1720,
"type": "timeFee",
"description": "time fee",
"description_cn": "时长费"
}
],
"is_pay": 1,
"oid": "1234567890",
"didi_oid": "didi_oid",
"pay_type": 0,
"pay_status": {
"is_pay": 1,
"permit": 0,
"type": 0
}
}