员工工号和钉钉userId的互查

业务场景

  1. 该接口用于对接钉钉待办/单据等其他业务,通过该接口查询员工钉钉userId和每刻员工工号的关系;

接口限制

 1. 10次/秒;
 2. 单次限制最多为5。

接口说明

  1. 单次查询工号数量限制最大为5。
  2. 通过idType决定请求参数中ids对应值的含义及接口作用。idType不填默认是empId。
    idType=empId,表示请求参数中ids是员工工号,接口为通过员工工号查询员工钉玎userId。
    idType=userId,表示请求参数中ids是员工钉玎userId,接口为通过员工钉玎userId查询员工工号。
  3. 该接口只会查到存在的员工工号或员工钉钉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 初始化
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2024-11-20 10:52:00

results matching ""

    No results matching ""

    results matching ""

      No results matching ""