# 获取企业管理员(平台号)

[异步回调] 获取企业管理员

接口说明:可通过该接口获取到机器人所属企业的企业管理员信息。

注:正常的操作场景普通的企业成员是无法查看企业管理员的信息的。但是当机器人符合扩容条件时,需要向企业管理员发起扩容申请,此处获取企业管理员的途径为该场景。因此若机器人当前不符合扩容条件时,是无法获取企业管理员的,该接口会调用失败。

请求方式:POST

请求地址:https://$basehost/gateway/qopen/CompanyAdmins

body参数

{
    "robot_id": "机器人id"
}
字段 类型 必填 说明
robot_id string 机器人id

返回值:

{
    "data": {
        "serial_no": "xxxxxx"
    },
    "errcode": 0,
    "errmsg": "",
    "hint": ""
}

返回说明

字段 类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
data json json返回值
   serial_no string 请求序列号
hint string 请求日志ID

处理结果,异步返回值:

{
    "event_type": 200022,
    "serial_no": "",
    "err_code": 0,
    "err_msg": "success",
    "robot_id": "机器人id",
    "data": {
        "members": [
            {
                "account_id": "企业微信userid",
                "member_id": "成员的id",
                "name": "姓名",
                "base64_name": "BASE64编码过后的用户姓名",
                "profile_photo": "头像",
                "gender": 1
            }
        ]
    }
}

返回说明

字段 类型 说明
event_type int 事件类型,200022
serial_no string 操作序列号
err_code int 状态码,0为正常,非0代表错误
err_msg string 错误信息
robot_id string 机器人id
data object 返回数据
data.members[x].account_id string 企业微信userid
data.members[x].member_id string 成员的id
data.members[x].name string 姓名
data.members[x].base64_name string BASE64编码过后的用户姓名
data.members[x].profile_photo string 头像
data.members[x].gender int 性别:1男 2女

完整请求示例:

curl -X POST \
  https://$basehost/gateway/qopen/CompanyAdmins \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
    "robot_id": "机器人id"
}'
最后更新时间: 2023/5/24 10:48:59