获取审批单详情
接口描述
审批单创建接口调用成功后,系统会生成一系列的临时用车规则,比如北京的送机、上海的接机、上海的市内用车等等。
通过审批单创建接口返回的审批单号调用该接口可以得到这些临时规则的详细信息,以便调起滴滴用车H5页
请求地址
https://api.es.xiaojukeji.com/river/Approval/detail
返回数据格式
JSON
请求类型
GET
请求参数
参数名称 | 数据类型 | 必选 | 说明 |
client_id | string | yes | 申请应用时分配的client_id |
access_token | string | yes | 授权后的access token |
timestamp | bigint | yes | 当前时间戳(精确到秒) |
company_id | string | yes | 企业ID |
approval_id | string | yes | 审批单号 |
sign | string | yes | 签名 |
请求示例
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" \
https://api.es.xiaojukeji.com/river/Approval/detail?client_id=client_id_test&access_token=access_token_test×tamp=1566764837&approval_id=781948394919012&company_id=12345678980&=sign=fba8dfb887afe16cb71c50b26a5eae0e
返回参数说明
参数名称 | 数据类型 | 说明 |
errno | int | 审批单ID |
errmsg | string | 成功时返回"SUCCESS",失败返回相应的错误信息 |
data | array | 审批单对应的用车规则 |
data中元素的结构
参数名称 | 数据类型 | 说明 |
rule_id | string | 用车规则id |
rule_name | string | 用车规则名称 |
rule_status | int | 用车规则状态(0正常;1删除;2停用;3已过期;4旧版本) |
city_id | int | 用车城市id |
city_name | string | 用车城市名称 |
scene_id | string | 用车场景id(101差旅;102行前审批) |
use_scene | int | 用车类型(0市内用车;1接机/站;2送机/站) |
car_total_count | int | 用车总次数,单位:分,负数表示不限总次数 |
car_available_count | int | 剩余用车次数,单位:分,剩余次数=总次数-待支付订单-已支付订单 |
car_total_money | int | 用车总额度,单位:分 |
car_available_money | int | 剩余用车额度,单位:分,剩余额度=总额度-待支付订单-已支付订单 |
car_perorder_money | int | 用车每单限额,单位:分 |
start_time | string | 规则开始时间(格式:2020-10-01 00:00:00) |
end_time | string | 规则结束时间(格式:2020-10-05 12:00:00) |
返回示例
成功返回值
{
"errno":0,
"errmsg":"SUCCESS",
"data":[
{
"rule_id":"1125907942741178",
"rule_name":"行前审批单_夜间加班车-1125907942750397",
"rule_status":"0",
"city_name":"上海",
"scene_id":"102",
"start_time":"2020-09-15 23:27:10",
"end_time":"2020-09-16 07:00:00"
}
]
}
失败返回值
{
"errno":50505,
"errmsg":"获取审批单信息失败(未获取到规则id集合,请检查审批单id)",
"data": null
}
接口错误解决方案
通用错误解决文档
- 4xx 错误
- 1xxx 错误
50505(获取审批单信息失败(未获取到规则id集合,请检查审批单id))
审批单号可能不存在