开发 地图小程序OPENAPI 开发指南 资源权限 角色资源权限

成员角色的资源权限 最后更新时间: 2024年08月30日

产品简介

地图成员有不同的角色:超管、管理员、普通成员;支持对普通成员这一角色统一设置资源权限。

提供设置、查询特定成员角色的资源权限的API能力。

资源类型目前支持:

1、文件夹

角色目前支持:

1、普通成员

使用限制

详细的服务调用量限制可点我查阅

使用说明

接收请求返回的数据(JSON或XML格式),参考返回参数文档解析数据。

如无特殊声明,接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。

1. 添加角色对资源的权限

请求地址

URL

https://restwia.amap.com/api/v1/wia/auth/role/resource/add

请求方式

POST

签名参数

workMapId resourceId

特别注意:

请求参数

参数名

含义

规则说明

参数类型

是否必填

缺省值

key

请求服务权限标识 

用户在高德地图官网申请Web服务API类型KEY 

string

bizToken

工作地图身份token

用户申请的工作地图身份token,一个企业一个token

string

bizSign

签名值

详见签名规则

string

workMapId

工作地图id

string

 roleId

角色id

取值说明:

详见附件

number

resourceId

资源id

string

authPackageId

权限包id

取值说明:

详见附件

number

示例代码(以java为例)

import com.amap.wia.openapi.test.lib.MyHttpUtils;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/demo-lib
import com.amap.wia.openapi.test.lib.SignatureHelper;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/biz-token-sign
/*
 * 通用 import 内容等暂略
 */
public static void main(String[] args) {
    String requestUrl = "https://restwia.amap.com/api/v1/wia/auth/role/resource/add";
    //url 参数
    Map<String, Object> param = new HashMap<>();
    param.put("key","在高德开放平台申请的key");
    param.put("bizToken","在高德开放平台申请的bizToken");
    param.put("openId","当前操作人openId");
    param.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret",new String[]{"workMapId","resourceId"}));
    param.put("workMapId","工作地图id");
    param.put("resourceId","资源id");
    param.put("roleId", "角色id");
    param.put("authPackageId", "权限包id");
    String s = MyHttpUtils.postFormUrlencoded(requestUrl,param);
    System.out.println("s = " + s);
}

返回参数

返回字段

含义

参数类型

规则说明

data

数据体

object

 

result

true/false

boolean

true:新增成功

code 

返回结果编码

number

见code说明

message

返回状态说明

string

成功时返回OK,否则返回错误原因

timestamp

时间戳

number

时间戳

code说明

0、异常

1、成功

2、失败

3、参数错误

100010biz sign error

100011、token not register

2. 修改角色对资源的权限

请求地址

URL

https://restwia.amap.com/api/v1/wia/auth/role/resource/modify

请求方式

POST

签名参数

workMapId resourceId

特别注意:

请求参数

参数名

含义

规则说明

参数类型

是否必填

缺省值

key

请求服务权限标识 

用户在高德地图官网申请Web服务API类型KEY 

string

bizToken

工作地图身份token

用户申请的工作地图身份token,一个企业一个token

string

bizSign

签名值

详见签名规则

string

workMapId

工作地图id

string

 roleId

角色id

取值说明:

详见附件

number

resourceId

资源id

string

authPackageId

权限包id

取值说明:

详见附件

number

示例代码(以java为例)

import com.amap.wia.openapi.test.lib.MyHttpUtils;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/demo-lib
import com.amap.wia.openapi.test.lib.SignatureHelper;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/biz-token-sign
/*
 * 通用 import 内容等暂略
 */
public static void main(String[] args) {
    String requestUrl = "https://restwia.amap.com/api/v1/wia/auth/person/resource/modify";
    //url 参数
    Map<String, Object> param = new HashMap<>();
    param.put("key", "在高德开放平台申请的key");
    param.put("bizToken", "在高德开放平台申请的bizToken");
    param.put("openId", "当前操作人openId");
    param.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret", new String[]{"workMapId", "resourceId"}));
    param.put("workMapId", "工作地图id");
    param.put("resourceId", "资源id");
    param.put("authPackageId", "权限包id");
    param.put("roleId", "角色id");
    String s = MyHttpUtils.postFormUrlencoded(requestUrl, param);
    System.out.println("s= " + s);
}

返回参数

返回字段

含义

参数类型

规则说明

data

数据体

object

 

 result

true/fasle

boolean

  true代表修改成功

code 

返回结果编码

number

见code说明

message

返回状态说明

string

成功时返回OK,否则返回错误原因

timestamp

时间戳

number

时间戳

code说明

0、异常

1、成功

2、失败

3、参数错误

100010biz sign error

100011、token not register

3. 批量修改角色对资源的权限

请求地址

URL

https://restwia.amap.com/api/v1/wia/auth/role/resource/modify/batch

请求方式

POST

签名参数

workMapId openId

特别注意:

请求参数

参数名

含义

规则说明

参数类型

是否必填

缺省值

key

请求服务权限标识 

用户在高德地图官网申请Web服务API类型KEY 

string

bizToken

工作地图身份token

用户申请的工作地图身份token,一个企业一个token

string

bizSign

签名值

详见签名规则

string

workMapId

工作地图id

string

openId

高德开放用户ID

当前操作人在高德的身份ID

string

 roleIds

角色id

取值说明:

详见附件

string

resourceIds

资源id

多个时用半角逗号分隔

string

authPackageId

权限包id

取值说明:

详见附件

number

示例代码(以java为例)

import com.amap.wia.openapi.test.lib.MyHttpUtils;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/demo-lib
import com.amap.wia.openapi.test.lib.SignatureHelper;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/biz-token-sign
/*
 * 通用 import 内容等暂略
 */
public static void main(String[] args) {
    String requestUrl = "https://restwia.amap.com/api/v1/wia/auth/role/resource/modify/batch";
    //url 参数
    Map<String, Object> param = new HashMap<>();
    param.put("key", "在高德开放平台申请的key");
    param.put("bizToken", "在高德开放平台申请的bizToken");
    param.put("openId", "当前操作人openId,必须是管理员或超管");
    param.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret", new String[]{"workMapId", "openId"}));
    param.put("workMapId", "工作地图id");
    param.put("roleIds", "角色id");
    param.put("resourceIds", "半角逗号分隔的多个资源id");
    param.put("authPackageId", "权限包id");
    String s = MyHttpUtils.postFormUrlencoded(requestUrl, param);
    System.out.println("s = " + s);
}

返回参数

返回字段

含义

参数类型

规则说明

data

数据体

object

 

 result

true/fasle

boolean

  true代表修改成功

code 

返回结果编码

number

见code说明

message

返回状态说明

string

成功时返回OK,否则返回错误原因

timestamp

时间戳

number

时间戳

code说明

0、异常

1、成功

2、失败

3、参数错误

1001、只有管理员可以操作

100010biz sign error

100011、token not register

4. 查询角色对资源的权限

请求地址

URL

https://restwia.amap.com/api/v1/wia/auth/role/resource/query

请求方式

POST

签名参数

workMapId resourceId

特别注意:

请求参数

参数名

含义

规则说明

参数类型

是否必填

缺省值

key

请求服务权限标识 

用户在高德地图官网申请Web服务API类型KEY 

string

bizToken

工作地图身份token

用户申请的工作地图身份token,一个企业一个token

string

bizSign

签名值

详见签名规则

string

workMapId

工作地图id

string

 roleId

角色id

取值说明:

详见附件

number

resourceId

资源id

string

示例代码(以java为例)

import com.amap.wia.openapi.test.lib.MyHttpUtils;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/demo-lib
import com.amap.wia.openapi.test.lib.SignatureHelper;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/biz-token-sign
/*
 * 通用 import 内容等暂略
 */
public static void main(String[] args) {
    String requestUrl = "https://restwia.amap.com/api/v1/wia/auth/role/resource/query";
    //url 参数
    Map<String, Object> param = new HashMap<>();
    param.put("key","在高德开放平台申请的key");
    param.put("bizToken","在高德开放平台申请的bizToken");
    param.put("openId","当前操作人openId");
    param.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret",new String[]{"workMapId","resourceId"}));
    param.put("workMapId","工作地图id");
    param.put("resourceId","资源id");
    param.put("roleId","角色id");
    String s = MyHttpUtils.postFormUrlencoded(requestUrl,param);
    System.out.println("s = " + s);
}

返回参数

返回字段

含义

参数类型

规则说明

data

数据体

object

 

 authPackageId

权限包id

number

取值说明:

详见附件

code 

返回结果编码

number

见code说明

message

返回状态说明

string

成功时返回OK,否则返回错误原因

timestamp

时间戳

number

时间戳

code说明

0、异常

1、成功

2、失败

3、参数错误

100010biz sign error

140003 无可匹配权限包

100011、token not register

附表

附:权限包id

1,可管理

2,可编辑

3,可查看

4,可新增

5,无权限

附:角色id

1,普通成员

返回顶部 示例中心 常见问题 智能客服 公众号
二维码