员工工号和钉钉userId的互查
业务场景
- 该接口用于对接钉钉待办/单据等其他业务,通过该接口查询员工钉钉userId和每刻员工工号的关系;
接口限制
1. 10次/秒;
2. 单次限制最多为5。
接口说明
- 单次查询工号数量限制最大为5。
- 通过idType决定请求参数中ids对应值的含义及接口作用。idType不填默认是empId。
idType=empId,表示请求参数中ids是员工工号,接口为通过员工工号查询员工钉玎userId。
idType=userId,表示请求参数中ids是员工钉玎userId,接口为通过员工钉玎userId查询员工工号。
- 该接口只会查到存在的员工工号或员工钉钉userId信息。
接口地址
/api/openapi/employee/search/user/ids?idType=userId
请求类型
POSt
请求参数
参数说明
字段名 |
字段类型 |
是否必填 |
字段字段说明 |
ids |
List<String> |
是 |
员工工号/钉钉userId 单次限制最多为5 |
参数样例
{
"ids":["aaaaa","bbbbb"]
}
响应参数
参数说明
参数 |
类型 |
说明 |
employeeId |
String |
员工工号 |
userId |
String |
员工钉玎userId |
参数样例
{
"code":"ACK",
"message":"",
"data":[
{
"employeeId":"aaaa",
"userId":"ssdasdafsaas"
},
{
"employeeId":"bbbb",
"userId":"dddsaf"
}
],
"args":null,
"linkDetail":false,
"nonBizError":false
}
修改记录
2023-03-07 初始化