详情

优质

小牛编辑

140浏览

2023-12-01

请求地址

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

请求方式

GET

返回数据格式

JSON

是否需要登录

是关于登录授权，参见如何登录授权

访问授权限制

暂无

请求参数

名称	类型	必选	描述
client_id	string	yes	申请应用时分配的AppKey
access_token	string	yes	授权后的access token
timestamp	int	yes	当前时间戳，精确到秒级
company_id	bigint	yes	企业ID
regulation_id	string	yes	制度ID
sign	string(32)	yes	签名

注意事项

返回结果中，souece=2或3时，表明此条制度是由需审批类的制度模板，通过员工申请、审批后生成，此时，以institution_id通过当前接口再次查询，可获得制度模板的详细信息
source：1代表通用规则，非审批而来，2代表行前审批，3代表差旅
　　source=2 & scene_type =1时，代表由行前审批制度，审批而来的自叫车
　　source=2 & scene_type =91时，代表由行前审批制度，审批而来的代叫车
　　source=3 & scene_type =1时，代表由差旅制度，审批而来的市内用车
　　source=3 & scene_type =92时，代表由差旅制度，审批而来的接送服务用车

请求示例

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

返回参数说明

返回值字段	字段类型	字段说明
errno	string	0表示成功，非0表示失败
errmsg	string	errno=0时为常量"SUCCESS"，errno!=0时为错误信息
data	object	制度信息

data数据格式

名称	类型	描述
regulation_id	string	制度id
regulation_name	string	制度名称
regulation_status	int	制度状态（0-停用 1-正常 2-删除 3-过期）
source	int	来源（1-通用规则 2-行前审批 3-差旅）
scene_type	int	因公出行场景（0-个人用车、1-商务出行、2-差旅、3-加班、4-办公地点通勤、5-疫期通勤、11-会议用车、91-代叫车、92-接送机、93-包车、94-代驾、95-私车同行、96-行前审批）
is_use_quota	int	是否使用个人限额（0-不使用、1-使用），差旅制度默认返回不使用
is_approve	int	制度是否需要审批(0-无需审批，1-需审批)
institution_id	string	制度模板ID
approval_type	int	审批类型(0-无需审批 1-差旅 2-行前审批按次数 3-行前审批按日期)

返回示例

{
    "errno":0,
    "errmsg":"SUCCESS",
    "data":[
        {
            "regulation_id":"9668294457792204005",
            "regulation_name":"xxxxxxx",
            "regulation_status":"0",
            "scene_type":"96",
            "is_use_quota":"0",
            "is_approval":"1",
            "institution_id":"9668294457792204001",
            "approval_type": 3
        }
    ]
}

接口错误解决方案

通用错误解决文档

4xx 错误
1xxx 错误