获取互联企业部门成员详情

POST

/cgi-bin/linkedcorp/user/list

服务端API企业内部开发

权限说明：仅自建应用可调用，应用须拥有指定部门的查看权限。

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/linkedcorp/user/list?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"department_id":"LINKEDID/DEPARTMENTID","fetch_child":true}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "userlist": [
    {
      "userid": "zhangsan",
      "name": "张三",
      "department": [
        "LINKEDID/1",
        "LINKEDID/2"
      ],
      "mobile": "+8612345678901",
      "telephone": "10086",
      "email": "zhangsan@tencent.com",
      "position": "后台开发",
      "corpid": "xxxxxx",
      "extattr": {
        "attrs": [
          {
            "name": "自定义属性(文本)",
            "value": "10086",
            "type": 0,
            "text": {
              "value": "10086"
            }
          },
          {
            "name": "自定义属性(网页)",
            "type": 1,
            "web": {
              "url": "https://work.weixin.qq.com/",
              "title": "官网"
            }
          }
        ]
      }
    }
  ]
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

userlist

array [object {9}]

必需

成员列表，user包含的属性可在管理端配置

userid

string

可选

成员UserID。对应管理端的帐号，企业内必须唯一。不区分大小写，长度为1~64个字节

name

string

成成员真实名称

可选

department

array[string]

可选

成员所属部门id列表，这个字段只会返回传入的department_id所属的互联企业里的部门id

mobile

string

手机号码

可选

telephone

string

座机

可选

string

邮箱

可选

position

string

职务信息

可选

corpid

string

可选

所属企业的corpid

extattr

object

扩展属性

可选

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

userlist

array[string]

可选

成员列表，user包含的属性可在管理端配置

errmsg

string

可选

对返回码的文本描述内容

修改于 2022-01-14 04:25:41

获取互联企业部门成员

获取互联企业部门列表