滴滴企业版

用于查询滴滴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

请求示例

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
use_company_money	是否企业支付余额	int	枚举值数字 0 否，1 是
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"
~~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
source	员工加入滴滴企业平台的渠道	int	枚举值数字： 0;未知 1;PC逐一添加 2;PC批量导入 3;邮件邀请

证件信息

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

响应示例

正常示例

{
	"data": {
		"records": [
			{
				"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"
				],
				"residentsname": "",
				"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
			}
		],
		"total": 78
	},
	"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