查询企业管理员

更新时间:2024-09-24 13:41:52

必须确保企业用户已授予平台appId获取其组织成员的管理权限,点击查看如何授权

  • manage_org_member- 授权允许获取企业/组织用户的组织成员的查询、新增、编辑、删除权限

接口描述

用于查询orgId企业机构下的管理员信息。

  • 企业机构默认管理员角色为首次操作企业实名认证的经办人员。企业机构实名认证通过后,自动将经办人设置为企业管理员。

接口地址&请求方法

接口地址:https://{host}/v3/organizations/{orgId}/administrators

请求方法:GET

请求头格式

具体请求头参数,请查看公共请求头格式

请求参数

参数名称

参数类型

必选

参数位置

参数说明

orgId

string

path

机构账号ID

【注】用户在系统注册实名后才有账号ID,账号ID获取方式请使用【查询机构认证信息】接口通过组织机构名称/组织机构证件号进行查询

响应参数

展开全部参数参数名称

参数类型

必选

参数说明

code

int32

业务码,0表示成功,非0表示异常。

message

string

业务信息

请根据 code 来判断错误情况,不应该依赖 message匹配,因为 message 可能会调整。

data(点击“+”展开详情)

object

业务数据

administrators(点击“+”展开详情)

array

企业管理员信息

psnId

string

管理员账号ID

psnName

string

管理员实名姓名

psnAccount

object

管理员账号标识

accountMobile

string

管理员手机号(账号标识,用于登录系统官网)

accountEmail

string

管理员邮箱地址(账号标识,用于登录系统官网)

employeeNum

string

员工编号

memberName

string

员工姓名/昵称

请求示例

GET https://bestcert.net/v3/organizations/0c5bd**8bfbf/administrators

响应示例

{
    "message": "执行成功",
    "code": 0,
    "data": {
        "administrators": [
            {
                "psnId": "c7e002***541e7",
                "psnAccount": {
                    "accountMobile": "183****0101",
                    "accountEmail": null
                },
                "employeeNum": "01",
                "memberName": "赵经理",
                "psnName": "赵四"
            }
        ]
    }
}

错误码

点击查看错误码