滴滴企业版

接口说明

说明

用于查询ES后台制度信息

基本信息

HTTP URL	/river/Regulation/get
HTTP Method	GET
权限要求

请求头

参数名称	参数值
Content-Type	application/x-www-form-urlencoded

请求参数

字段名	字段说明	字段类型	必填
client_id	申请应用时分配的AppKey	string	Y
access_token	授权后的access token	string	Y
company_id	公司 ID	string	Y
timestamp	当前时间戳	bigint	Y
sign	签名	string	Y

集团账户使用说明

如果采用集团账户方案，并且配置了由【上级公司统一对接】（具体配置请咨询滴滴侧对接人），对接路径、请求参数有如下变化：

HTTP URL：/open-apis/v2/regulation/get

新增参数：

字段名	字段名称	类型	是否必填	备注
belong_enterprise_name	归属企业名称	string	N	company_id传集团公司ID时，可通过该字段确定处理哪个子公司的数据 company_id传子公司ID时，该字段可以不传该字段与taxpayer_no任选一个传值该字段需要与企业开户时认证名称一致
taxpayer_no	纳税人识别号	string	N	company_id传集团公司ID时，可通过该字段确定处理哪个子公司的数据 company_id传子公司ID时，该字段可以不传该字段与belong_enterprise_name任选一个传值需要与集团公司的公司档案里的纳税人识别号一致
query_sub_company	是否查询下级公司数据	boolean	N	true：查询当前公司以及下级公司数据 false：仅查询当前公司数据（默认值）
next_token	下一页的token	string	N	首次查询不需要传，首次后的每一次查询需要从上一次查询的响应（data.next_token)中获取拿到该值

请求示例

curl -X GET -H "Content-Type: application/x-www-form-urlencoded" https://api.es.xiaojukeji.com/river/Role/get?client_id=client_id_test&access_token=141ea31466478eab2f1c1ddcca2675b989a16552&timestamp=1566764837&company_id=12345678980&sign=091cf244ad5ab16935cfe44fc698bc58

响应参数

字段名	字段说明	字段类型
errno	0表示成功，非0表示失败	int
errmsg	errno=0时为常量"SUCCESS"，errno!=0时为错误信息	string
data		array

data数组元素格式

字段名	字段说明	字段类型	备注
regulation_id	制度id	string
regulation_name	制度名称	string
regulation_status	制度状态	int	（0-停用 1-正常 2-删除 3-过期）
source	来源	int	来源（1-通用规则 2-行前审批 3-差旅 4-无需审批）注：列表只查询es后台制度，因此这里只返回1-通用规则
scene_type	因公出行场景	int	（0-个人用车、1-商务出行、2-需审批差旅制度、3-加班、4-办公地点通勤、5-疫期通勤、11-会议用车、91-代叫车、92-接送机、93-包车、94-代驾、95-私车同行、96-行前审批、104-无需审批差旅制度）
is_use_quota	是否使用个人限额	int	（0-不使用、1-使用），差旅制度默认返回不使用
is_approve	制度是否需要审批	int	(0-无需审批，1-行前审批，2-差旅)
city_type	管控方式	int	管控方式（0-不管控、1-中度管控、2-严格管控、3-交叉预定（轻度管控）、4-会议管控）。默认值-1无意义
approval_type	审批类型	int	(0-无需审批 1-差旅 2-行前审批按次数 3-行前审批按日期)

集团账户场景使用说明

如果采用集团账户方案，并且配置了由【上级公司统一对接】（具体配置请咨询滴滴侧对接人），响应参数有如下变化：

字段名	字段说明	字段类型	备注
next_token	下一页的token	string	下一次请求需要的next_token为空字符串或空指针（null）说明没有下一页

响应示例

正常示例

{
    "errno":0,
    "errmsg":"SUCCESS",
    "data":[
        {
            "regulation_id":"9668294457792204005",
            "regulation_name":"xxxxxxx",
            "regulation_status":"0",
            "scene_type":"4",
            "is_use_quota":"0",
            "is_approval":"1",
            "source": 1,
            "city_type": 0,
            "approval_type": 0
        }
    ]
}

异常示例

错误码

通用错误解决方案

4xx 错误
1xxx 错误

版本记录

日期	更新内容	上线时间
2023.11.16	迁移文档
2025.2.8	新增source、approval_type及说明
2025.05.08	新增city_type说明