开发 地图小程序OPENAPI 开发指南 资源权限 人员资源权限

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

产品简介

提供设置、查询单个成员资源权限的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

示例代码(以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/add";
    //url 参数
    HashMap<String, Object> param = Maps.newHashMap();
    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");
    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/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

示例代码(以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");
        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/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

示例代码(以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/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("openIds","半角逗号分隔的高德用户开放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/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

示例代码(以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/remove";
    //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");
    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

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

示例代码(以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/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("mergeRoleAuth","是否合并查询角色权限(boolean)");
    String s = MyHttpUtils.postFormUrlencoded(requestUrl,param);
    System.out.println("s = " + s);
}

返回参数

返回字段

含义

参数类型

规则说明

data

数据体

object

 

 authPackageId

权限包id

number

取值说明:

1可管理,2可编辑,3可查看,4可新增,5无权限

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,可新增

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