单个成员的资源权限 最后更新时间: 2023年08月14日
产品简介
提供设置、查询单个成员资源权限的API能力。
资源类型目前支持：
1、文件夹
使用限制
详细的服务调用量限制可点我查阅。
使用说明
接收请求返回的数据（JSON或XML格式），参考返回参数文档解析数据。
如无特殊声明，接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。
1. 添加成员对资源的权限
请求地址
URL | https://restwia.amap.com/api/v1/wia/auth/person/resource/add |
请求方式 | POST |
签名参数 | workMapId resourceId |
特别注意：
请求参数
参数名 | 含义 | 规则说明 | 参数类型 | 是否必填 | 缺省值 | |
key | 请求服务权限标识 | 用户在高德地图官网申请Web服务API类型KEY | string | 是 | 无 | |
bizSign | 签名值 | string | 是 | 无 | ||
bizToken | 工作地图身份token | 用户申请的工作地图身份token，一个企业一个token | string | 是 | 无 | |
workMapId | 工作地图id | string | 是 | 无 | ||
openId | 人员id | string | 是 | 无 | ||
resourceId | 资源id | string | 是 | 无 | ||
authPackageId | 权限包id | 取值说明： 详见附件 | number | 是 | 无 | |
返回参数
返回字段 | 含义 | 参数类型 | 规则说明 | |||||
data | 数据体 | object |
| |||||
result | true/false | boolean | true:新增成功 | |||||
code | 返回结果编码 | number | 见code说明 | |||||
message | 返回状态说明 | string | 成功时返回OK，否则返回错误原因 | |||||
timestamp | 时间戳 | number | 时间戳 | |||||
code说明
0、异常 |
1、成功 |
2、失败 |
3、参数错误 |
100010、biz sign error |
100011、token not register |
2. 修改成员对资源的权限
请求地址
URL | https://restwia.amap.com/api/v1/wia/auth/person/resource/modify |
请求方式 | POST |
签名参数 | workMapId resourceId |
特别注意：
请求参数
参数名 | 含义 | 规则说明 | 参数类型 | 是否必填 | 缺省值 | |
key | 请求服务权限标识 | 用户在高德地图官网申请Web服务API类型KEY | string | 是 | 无 | |
bizSign | 签名值 | string | 是 | 无 | ||
bizToken | 工作地图身份token | 用户申请的工作地图身份token，一个企业一个token | string | 是 | 无 | |
workMapId | 工作地图id | string | 是 | 无 | ||
openId | 人员id | string | 是 | 无 | ||
resourceId | 资源id | string | 是 | 无 | ||
authPackageId | 权限包id | 取值说明： 详见附件 | number | 是 | 无 | |
返回参数
返回字段 | 含义 | 参数类型 | 规则说明 | |||||
data | 数据体 | object |
| |||||
result | true/fasle | boolean | true代表修改成功 | |||||
code | 返回结果编码 | number | 见code说明 | |||||
message | 返回状态说明 | string | 成功时返回OK，否则返回错误原因 | |||||
timestamp | 时间戳 | number | 时间戳 | |||||
code说明
0、异常 |
1、成功 |
2、失败 |
3、参数错误 |
100010、biz sign error |
100011、token not register |
3. 批量修改成员对资源的权限
请求地址
URL | https://restwia.amap.com/api/v1/wia/auth/person/resource/modify/batch |
请求方式 | POST |
签名参数 | workMapId openId |
特别注意：
请求参数
参数名 | 含义 | 规则说明 | 参数类型 | 是否必填 | 缺省值 | |
key | 请求服务权限标识 | 用户在高德地图官网申请Web服务API类型KEY | string | 是 | 无 | |
bizSign | 签名值 | string | 是 | 无 | ||
bizToken | 工作地图身份token | 用户申请的工作地图身份token，一个企业一个token | string | 是 | 无 | |
workMapId | 工作地图id | string | 是 | 无 | ||
openId | 当前操作人 | 高德用户的开放id，必须是管理员或超管 | string | 是 | 无 | |
openIds | 被操作的人员 | 半角逗号分隔的高德用户开放id | string | 是 | 无 | |
resourceIds | 资源id | 半角逗号分隔的多个资源id | string | 是 | 无 | |
authPackageId | 权限包id | 取值说明： 详见附件 | number | 是 | 无 | |
返回参数
返回字段 | 含义 | 参数类型 | 规则说明 | |||||
data | 数据体 | object |
| |||||
result | true/fasle | boolean | true代表修改成功 | |||||
code | 返回结果编码 | number | 见code说明 | |||||
message | 返回状态说明 | string | 成功时返回OK，否则返回错误原因 | |||||
timestamp | 时间戳 | number | 时间戳 | |||||
code说明
0、异常 |
1、成功 |
2、失败 |
3、参数错误 |
1001、只有管理员可以操作 |
100010、biz sign error |
100011、token not register |
4. 删除成员对资源的权限
请求地址
URL | https://restwia.amap.com/api/v1/wia/auth/person/resource/remove |
请求方式 | POST |
签名参数 | workMapId resourceId |
特别注意：
请求参数
参数名 | 含义 | 规则说明 | 参数类型 | 是否必填 | 缺省值 | |
key | 请求服务权限标识 | 用户在高德地图官网申请Web服务API类型KEY | string | 是 | 无 | |
bizToken | 工作地图身份token | 用户申请的工作地图身份token，一个企业一个token | string | 是 | 无 | |
bizSign | 签名值 | string | 是 | 无 | ||
workMapId | 工作地图id | string | 是 | 无 | ||
openId | 人员id | string | 是 | 无 | ||
resourceId | 资源id | string | 是 | 无 | ||
返回参数
返回字段 | 含义 | 参数类型 | 规则说明 | |||||
data | 数据体 | object |
| |||||
result | true/fasle | boolean | true代表删除成功 | |||||
code | 返回结果编码 | number | 见code说明 | |||||
message | 返回状态说明 | string | 成功时返回OK，否则返回错误原因 | |||||
timestamp | 时间戳 | number | 时间戳 | |||||
code说明
0、异常 |
1、成功 |
2、失败 |
3、参数错误 |
100010、biz sign error |
100011、token not register |
5. 查询成员对资源的权限
请求地址
URL | https://restwia.amap.com/api/v1/wia/auth/person/resource/query |
请求方式 | POST |
签名参数 | workMapId resourceId |
特别注意：
请求参数
参数名 | 含义 | 规则说明 | 参数类型 | 是否必填 | 缺省值 | |
key | 请求服务权限标识 | 用户在高德地图官网申请Web服务API类型KEY | string | 是 | 无 | |
bizToken | 工作地图身份token | 用户申请的工作地图身份token，一个企业一个token | string | 是 | 无 | |
bizSign | 签名值 | string | 是 | 无 | ||
workMapId | 工作地图id | string | 是 | 无 | ||
openId | 人员id | string | 是 | 无 | ||
resourceId | 资源id | string | 是 | 无 | ||
mergeRoleAuth | 合并查询角色权限 | 为false时只查人员通过上面的接口设置的权限，为true时查询人员对资源的最终权限：人员权限+角色权限 | boolean | 否 | true | |
返回参数
返回字段 | 含义 | 参数类型 | 规则说明 | |||||
data | 数据体 | object |
| |||||
authPackageId | 权限包id | number | 取值说明： 1可管理,2可编辑,3可查看,4可新增,5无权限 | |||||
code | 返回结果编码 | number | 见code说明 | |||||
message | 返回状态说明 | string | 成功时返回OK，否则返回错误原因 | |||||
timestamp | 时间戳 | number | 时间戳 | |||||
code说明
0、异常 |
1、成功 |
2、失败 |
3、参数错误 |
100010、biz sign error |
140003 无可匹配权限包 |
100011、token not register |
附表
附：权限包id
1，可管理 |
2，可编辑 |
3，可查看 |
4，可新增 |
