必须确保企业用户已授予平台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": "赵四"
}
]
}
}