应用角色
添加角色成员
根据鉴权方式查看“添加角色成员”对应的真实 API 地址、参数与响应。
鉴权方式
AppKey + Sign 是应用密钥鉴权,由管理员创建,用于以应用管理员身份访问应用数据。
版本
请求地址
Path 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
role_id | string | 是 | 角色ID |
Header 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
HAP-Appkey | string | 是 | HAP应用密钥 |
HAP-Sign | string | 是 | HAP签名 |
Body 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
userIds | string[] | 否 | 用户ID合集 |
departmentIds | string[] | 否 | 部门ID合集 |
departmentTreeIds | string[] | 否 | 部门树ID合集(包含子部门) |
jobIds | string[] | 否 | 职位ID合集 |
projectOrganizeIds | string[] | 否 | 组织角色ID合集 |
响应参数
200成功添加角色成员| 名称 | 类型 | 描述 |
|---|---|---|
success | boolean | 是否调用成功 |
error_code | integer | 错误代码 |
error_msg | string | 错误消息 |
data | object | 空对象 |
curl -X POST "https://example.com/v3/app/roles/role_id/members" \ -H "HAP-Appkey: {{HAP-Appkey}}" \ -H "HAP-Sign: {{HAP-Sign}}" \ -H "Content-Type: application/json" \ -d '{ "userIds": [ "user123", "user456" ], "departmentIds": [ "dept123" ], "departmentTreeIds": [ "deptTree123" ], "jobIds": [ "job123", "job456" ], "projectOrganizeIds": [ "org123" ] }'{ "data": { "addedCount": 5, "successUsers": [ "user123", "user456" ], "successDepartments": [ "dept123" ], "failedItems": [] }, "success": true}