用户
获取外部门户人员列表
获取外部门户的人员列表。
鉴权方式
HAP 组织授权开放接口为每个组织提供一套独立的密钥信息(AppKey 和 SecretKey),组织可通过此密钥信息安全调用 HAP 平台开放的各类接口,包括人员组织管理、汇报关系管理、应用管理、流程待办等数据接口。
版本
请求地址
Body 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
appKey | string | 是 | 应用 Key |
sign | string | 是 | 签名 |
timestamp | string | 是 | 时间戳 |
projectId | string | 是 | 项目 ID |
pageIndex | string | 是 | 当前页码 |
pageSize | string | 是 | 每页数量 |
appId | string | 否 | 应用 ID |
响应参数
200成功响应| 名称 | 类型 | 描述 |
|---|---|---|
data | object | — |
data.count | integer | 用户总数 |
data.users | object[] | — |
data.users.accountId | string | 用户账号ID |
data.users.mobilePhone | string | 用户手机号 |
data.users.email | string | 用户邮箱 |
data.users.name | string | 用户名 |
data.users.avatar | string | 用户头像URL |
data.users.appId | string | 应用ID |
data.users.createTime | string | 用户创建时间 |
data.users.lastTime | string | 最后活动时间 |
code | integer | 响应码 |
message | string | 响应信息 |
curl -X POST "https://example.com/generalintegrate/v2/ExternalPortal/GetUsers" \ -H "Content-Type: application/json" \ -d '{ "appKey": "a9455c30bd12d0c4", "sign": "ZmUyYWQ0YzljZjZmOGU5MzBmYzE5MDU3NjBlNDc3NTdkODIzNzk0NjA5ZmY5N2YzOGYxNTllZDc1MWRkYzljNA==", "timestamp": "1767595805516", "projectId": "fe288386-3d26-4eab-b5d2-51eeab82a7f9", "pageIndex": "1", "pageSize": "100" }'{ "data": { "count": 355, "users": [ { "accountId": "a#********", "mobilePhone": "+86***********", "email": "user@example.com", "name": "测试用户", "avatar": "https://dn-mdpic.mingdao.com/UserAvatar/default.png?imageView2/1/w/100/h/100/q/90", "appId": "81aef775-bb99-468d-9e6e-baebb476acfd", "createTime": "2025-12-29 14:34:57", "lastTime": "2025-12-29 14:34:57" } ] }, "code": 1, "message": ""}