滴滴企业版

用于查询滴滴ES后台已有的人员明细

接口说明

注意

员工工号、手机号是精确查询，名字为模糊查询
offset必须可以被length整除，如offset=0,length=100,0可以被100整除，合法；offset=1,length=100,1不能被100整除，不合法

说明

用户如果传了 last_id，除了 status，其他检索条件会失效
当 status 为空或者没传，返回的为正常、离职和未绑手机号的员工
birth_date加密格式，返回的参数需要重新提供

基本信息

HTTP URL	/river/Member/detail
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	当前时间戳(精确到秒级)	int	Y
sign	签名	string	Y
member_id	员工滴滴ID	string	N
employee_number	员工工号	string	N	存在member_id时，该字段不生效
phone	员工手机号	string	N	使用海外手机号时输入格式为 +90 137****0001 ，国内可以不加区号

请求示例

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

响应参数

字段名	字段说明	字段类型	备注
errno	错误编码	string	数字 0 表示成功，非0 表示失败
errmsg	错误信息	string	errno=0时为常量"SUCCESS"，errno!=0时为错误信息
data	员工信息	object

data数据格式

字段名	字段说明	字段类型	备注
member_id	员工在滴滴企业平台的ID	bigint
phone	员工手机号	string
realname	员工姓名	string
employee_number	员工工号	string	员工在公司的员工号
email	邮箱	string
system_role	系统角色	int	枚举值数字 0 车辆预定人员，1 普通管理员，2 超级管理员
role_ids	角色	string	可以通过角色API获取对应的ID
immediate_superior_phone	员工直属上级的手机号码	string	直属上级可在审批流中担任审批人
immediate_superior_eid	员工直属上级的员工编号	string
residentsname	常驻地中文	string	支持地级市、区县维度区县示例："北京-海淀区"
residents_list	常驻地列表	[]object
use_company_money	是否企业支付余额	int	枚举值数字 0 否，1 是 1 是：员工预订符合管控规则，可由企业直接支付 0 否：员工需要个人支付
total_quota	限额	string	单位元该字段所对应的周期为【员工限额管理】中【员工个人限额（默认）】规则的周期
is_remark	叫车时备注信息是否必填	string	枚举值数字 0 选填，1 必填，2 按制度填写
budget_center_id	所在主岗部门ID	bigint
con_department_ids	所在兼岗部门ID	array	兼岗部门ID数组
use_car_config	用车规则ID数组	array
project_ids	所在项目ID	string
~~available_quota~~	员工可用限额	string	单位元例如"937.70” 历史字段，建议使用limit_rule_list限额规则查询
~~branch_name~~	所在分公司名称（老），后续此参数会去掉	string	所在分公司名称（老），后续此参数会去掉
~~department~~	部门名称（老），后续此参数会去掉	string	部门名称（老），后续此参数会去掉
regulation_id	用车制度ID数组	array	跟新增、修改、详情等API统一
set_dismiss_time	设置的员工离职日期	string	为空时表示未设置离职日期，格式为 yyyy-MM-dd
dismiss_time	员工实际离职日期	string	为空时表示未离职,格式为格式：yyyy-MM-dd HH:mm:ss
invoice_info	开票主体信息	string
legal_entity_id	所在公司主体id	string
out_legal_entity_id	外部公司主体编号	string
rank_id	职级id	string
out_rank_id	外部职级 ID	string
english_surname	英文姓	string	同lastname
english_name	英文名	string	同firstname 有middlename时 english_name=firstname middlename
nickname	昵称	string
sex	性别	int	枚举值数字 0 未知 1 男 2 女
birth_date	出生日期	string	格式2000-01-01（已用AES算法加密）
card_list	证件信息	[]object
cert_realname	证件中文姓名	string	证件上的真实中文姓名，不超过50个字符
cert_english_surname	证件英文姓	string	证件上的真实英文姓，不超过50个字符
cert_english_name	证件英文名	string	证件上的真实英文名，不超过50个字符
source	员工加入滴滴企业平台的渠道	int	枚举值数字： 0：未知 1：PC逐一添加 2：PC批量导入 3：邮件邀请 4：API添加
status	员工状态	int	1 正常、4 离职、6 未绑定手机号
limit_rule_list	限额规则	[]object

证件信息

字段名	字段说明	字段类型	备注
card_type	证件类型	int	枚举值数字 1. 身份证，2. 护照，3. 港澳台居民居住证，4. 台胞证，5. 军官证，6. 回乡证，7. 外国人永久居留身份证
card_no	证件号码	string	证件号码（已用AES算法加密）
expire_date	证件过期日期	string	格式：2050-01-01（已用AES算法加密）

常驻地信息

字段名	字段说明	字段类型
id	常驻地ID	int
name	常驻地名称	string
adcode	常驻地行政区划代码	string

限额规则

字段名	字段说明	字段类型	备注
rule_name	限额规则名称	string	限额规则员工侧展示名称
budget_cycle	预算周期	int	枚举值数字 0：不限额；1：自然月；2：自然季度；3：自然年；4：一次性；5：自然日；6：自定义；7：使用原部门的周期
is_accumulative	是否累计	int	0 不可累计 1 可累计
total_quota	限额	number	单位元 0 表示不限额度精确到两位小数
available_quota	剩余额度	number	单位元精确到两位小数
freeze_quota	冻结金额	number	单位元精确到两位小数

响应示例

正常示例

{
	"data": {
				"available_quota": "0.00",
				"birth_date": "",
				"branch_name": "",
				"budget_center_id": "1125915646135311",
				"card_list": [],
				"department": "",
				"dismiss_time": "",
				"email": "",
				"employee_number": "",
				"english_name": "",
				"english_surname": "",
				"guest_car_right": 0,
				"id": "1125922289295589",
				"immediate_superior_phone": "",
				"invoice_info": "",
				"is_remark": "0",
				"legal_entity_id": "",
				"month_quota": "0.00",
				"nickname": "",
				"phone": "00016189857",
				"rank_id": "",
				"realname": "ZHOUZH",
				"regulation_id": [
					"1125920826148759",
					"1125920865383421",
					"1125921094573032",
					"1125921250369120",
					"1125921427436424",
					"1125921613870672",
					"1125922048768926",
					"1125922090841891",
					"1125922157944715",
					"1125921539238327"
				],
                "con_department_ids": [
					"1125920823148798",
					"1125928765383351"
				],
				"residentsname": "",
                "residents_list": [
                      {
                        "id": 14,
                        "name": "大连",
                        "adcode": "210200"
                      },
                      {
                        "id": 13,
                        "name": "青岛",
                        "adcode": "370200"
                      }
                ],
				"role_ids": "1125915646090887_1125915646107623",
				"set_dismiss_time": "",
				"sex": 0,
				"system_role": 2,
				"total_quota": "0.00",
				"use_car_config": [
					"1125920826148759",
					"1125920865383421",
					"1125921094573032",
					"1125921250369120",
					"1125921427436424",
					"1125921613870672",
					"1125922048768926",
					"1125922090841891",
					"1125922157944715",
					"1125921539238327"
				],
				"use_company_money": 1,
                "limit_rule_list": [
                    {
                        "rule_name": "限额1",
                        "budget_cycle": 1,
                        "is_accumulative": 0,
                        "total_quota": 1000,
                        "limit_management_scope": 0,
                        "available_quota": 1000,
                        "freeze_quota": 0
                    },
                    {
                        "rule_name": "员工个人限额（默认）",
                        "budget_cycle": 1,
                        "is_accumulative": 0,
                        "total_quota": 50000,
                        "limit_management_scope": 0,
                        "available_quota": 50000,
                        "freeze_quota": 0
                    }
                ]
	},
	"errmsg": "SUCCESS",
	"errno": 0,
	"request_id": "i+2SqRl3AcnS5Pi2KXWdxmg2e0lfei3pChBPvy/LuvjTkLo9LWXpUj4Jf2du2ZwE"
}

异常示例

错误码

通用错误解决方案

版本记录

日期	更新人	更新内容	上线时间
2023.11.07	陈继诗	迁移文档
2024.01.26	陈继诗	增加source字段	2024.04.26
2023.11.07	陈继诗	增加employee_number请求字段,返回增加immediate_superior_eid	2024.04.26
2025.02.13	高洋洋	返回新增con_department_ids兼岗部门	2025.02.13
2025.03.20	唐腾飞	返回新增out_legal_entity_id	2025.03.26
2025.05.15	杨露佳	返回新增 residents_list	2025.05.15
2025.11.17	谢朱莉	1.响应参数增加员工状态 2.增加证件姓名相关字段	2025.11.10
2026.1.21	谢朱莉	常驻地支持区县	2026.1.21
2026.02.09	郭相均、谢朱莉	限额接口升级	2026.02.09
2026.03.24	谢朱莉	新增常驻地行政区划代码	2026.03.24