滴滴企业版

接口说明

说明

用于删除滴滴ES后台人员信息

基本信息

HTTP URL	/river/Member/del
HTTP Method	POST
权限要求

请求头

参数名称	参数值
Content-Type	application/json

请求参数

字段名	字段说明	字段类型	必填	备注
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	员工在滴滴企业的ID（同员工新增接口中返回的id；删除多个员工时，员工号需要以"_"隔开，一次最多删除100条）member_id与employee_number同时存在以member_id为准。
employee_number	员工工号	string	N	员工在滴滴企业的工号，json 字符串（一次最多删除100条），member_id和employee_number仅有一个生效，不能同时为空，member_id 优先级高于employee_number, 示例： [\"D1001\", \"D1002\", \"D1003\"]

请求示例

curl -X POST -H "content-type:application/json" \
-d '{"client_id":"client_id_test","access_token":"access_token_test","timestamp":1565875844,"company_id":"12345678980","member_id":"4595547807125341222_4596091316915930212","sign":"7473eb9bff6e1aa352dd2e433ed1924a"}' \
https://api.es.xiaojukeji.com/river/Member/del

响应参数

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

响应示例

全部删除

{
    "errno":0,
    "errmsg":"success",
    "data":[
        2992137043884639000,
        2992137043884639000,
        2992137043884639000
    ]
}

部分删除

{
    "errno":0,
    "errmsg":"以下员工有未结束或未支付订单:2992137043884639250_2992137043884639251_2992137043884639252",
    "data":[
        2992137043884639000,
        2992137043884639000,
        2992137043884639000
    ]
}

错误码

通用错误解决方案

4xx 错误

1xxx 错误

员工删除失败的可能原因

删除的员工id不存在

初始管理员不能删除(如果想要删除初始管理员，需要先将管理员权限转让给其他人，然后再删除)

删除的员工有待报销单或未支付的订单

删除的员工已离职

版本记录

日期	更新人	更新内容	上线时间
2023.11.07	陈继诗	迁移文档
2023.11.10	陈继诗	请求增加employee_number字段	2024.01.04