获取成员信息接口

POST

/v5/corp/user/get

获取成员信息接口

根据 username 获取指定成员的名称和部门编号。支持公共模式和集成模式。

接口版本：

接口版本	更新时间	版本说明
v1	2018.12.4	使用 _id 作为 id
v2	2019.6.21	使用 username 作为 id
v4	2022.6.30	返回值新增字段 type、status、integrate_id
v5	2022.10.28	在 v4 的基础上，接口请求频率由 5 次/秒提升至 30 次/秒；参数 username 放入body，接口路由修改为 POST corp/user/get

**请求地址：**https://api.jiandaoyun.com/api/v5/corp/user/get

**请求频率：**30 次/秒

请求方式：POST

请求参数：

参数	必需	类型	说明
username	是	String	成员编号

请求示例：

{
    "username": "jiandaoyun"
}

响应内容：

参数	含义
user	成员信息，同单个成员的返回数据结构

响应示例：

{
  "user": {
    "username": "jiandaoyun",
    "name": "小云",
    "departments": [1,3],
    "type": 0,
    "status": 1,
    "integrate_id": "jiandaoyun"
  }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

username

string

成员编号

必需

示例

{
    "username": "jiandaoyun"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.jiandaoyun.com/api/v5/corp/user/get' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "jiandaoyun"
}'

返回响应

🟢200成功

application/json

Body

user

object

必需

成员信息，同单个成员的返回数据结构

username

string

必需

name

string

必需

departments

array[number]

必需

type

number

必需

status

number

必需

integrate_id

string

必需

示例

{
    "user": {
        "username": "jiandaoyun",
        "name": "小云",
        "departments": [
            1,
            3
        ],
        "type": 0,
        "status": 1,
        "integrate_id": "jiandaoyun"
    }
}

corp

添加成员接口

获取成员信息接口