查询

优质

小牛编辑

131浏览

2023-12-01

接口描述

审批单创建接口调用成功后，系统会生成一系列的临时用车规则，比如北京的送机、上海的接机、上海的市内用车等等。
通过审批单创建接口返回的审批单号调用该接口可以得到这些临时规则的详细信息，以便调起滴滴用车H5页

请求地址

https://api.es.xiaojukeji.com/river/Approval/detail

返回数据格式

JSON

请求类型

GET

请求参数

参数名称	数据类型	必选	说明
client_id	string	yes	申请应用时分配的client_id
access_token	string	yes	授权后的access token
timestamp	string	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&timestamp=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送机/站）
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))

审批单号可能不存在