企业组织 最后更新时间: 2024年08月30日
产品介绍
该 API 是通过 HTTPS 协议访问远程服务的接口，提供修改组织信息、添加/移除组织成员、修改组织成员信息的能力。
使用限制
详细的服务调用量限制可点我查阅。
业务身份和业务签名
bizToken和bizSign的详情见：点我查阅 。
使用说明
如无特殊声明，接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。
1.获取组织信息
如无特殊声明，接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。
请求地址
请求参数
示例代码（以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 url = "https://restwia.amap.com/api/v1/wia/org/info";
Map<String, Object> params = new HashMap<>();
String openId = "当前操作用户的openId";
params.put("key","在高德开放平台申请的key");
params.put("openId",openId);
params.put("bizToken","在高德开放平台申请的bizToken");
String[] signArgs = new String[]{openId};
params.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret",signArgs));
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}
返回参数
2. 修改组织信息
请求地址
请求参数
示例代码（以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 url = "https://restwia.amap.com/api/v1/wia/org/update";
Map<String, Object> params = new HashMap<>();
String openId = "当前操作用户的openId";
params.put("key", "在高德开放平台申请的key");
params.put("openId", openId);
params.put("bizToken", "在高德开放平台申请的bizToken");
String[] signArgs = new String[]{openId};
params.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret", signArgs));
params.put("orgName", "更新后的组织名称");
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}
返回参数
附表
3. 添加组织成员
请求地址
特别注意：暂无。
请求参数
示例代码（以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 url = "https://restwia.amap.com/api/v1/wia/org/member/add";
Map<String, Object> params = new HashMap<>();
params.put("key", "在高德开放平台申请的key");
//被移除人在组织中的openId，可通过获取开放账号接口获取
String openId = "被移除人在组织中的openId";
params.put("openId", openId);
//组织的bizToken
params.put("bizToken", "在高德开放平台申请的bizToken");
String[] signArgs = new String[]{openId};
params.put("bizSign", SignatureHelper.calcSign(env.getBizSecret(), signArgs));
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}返回参数
附表
4. 移除组织成员
请求地址
特别注意：暂无。
请求参数
示例代码（以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 url = "https://restwia.amap.com/api/v1/wia/org/member/delete";
Map<String, Object> params = new HashMap<>();
params.put("key", "在高德开放平台申请的key");
//被移除人在组织中的openId，可通过获取开放账号接口获取
String openId = "被移除人在组织中的openId";
params.put("openId", openId);
//组织的bizToken
params.put("bizToken", "在高德开放平台申请的bizToken");
String[] signArgs = new String[]{openId};
params.put("bizSign", SignatureHelper.calcSign(env.getBizSecret(), signArgs));
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}返回参数
附表
5. 修改组织成员信息
请求地址
特别注意：暂无。
请求参数
示例代码（以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 url = "https://restwia.amap.com/api/v1/wia/org/member/update";
Map<String, Object> params = new HashMap<>();
String openId = "当前操作用户的openId";
params.put("key", "在高德开放平台申请的key");
params.put("openId", openId);
params.put("bizToken", "在高德开放平台申请的bizToken");
String[] signArgs = new String[]{openId};
params.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret", signArgs));
params.put("nickname", "修改后的用户昵称");
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}
返回参数
附表
6. 管理员修改任意组织成员信息
请求地址
特别注意：
- nickname 和 icon 不能同时为null。
请求参数
示例代码（以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 url = "https://restapi.amap.com/api/v1/wia/org/member/modify";
Map<String, Object> params = new HashMap<>();
String openId = "当前操作用户的openId";
params.put("key", "在高德开放平台申请的key");
params.put("openId", openId);
params.put("bizToken", "在高德开放平台申请的bizToken");
String[] signArgs = new String[]{openId};
params.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret", signArgs));
params.put("empOpenId", "被修改人员的高德的身份ID");
params.put("nickname", "修改后的用户昵称");
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}
返回参数
附表
7. 批量查询企业成员
请求地址
特别注意：暂无。
请求参数
示例代码（以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 url = "https://restwia.amap.com/api/v1/wia/org/member/list";
Map<String, Object> params = new HashMap<>();
String openId = "当前操作用户的openId";
params.put("key", "在高德开放平台申请的key");
params.put("openId", openId);
params.put("bizToken", "在高德开放平台申请的bizToken");
String[] signArgs = new String[]{openId};
params.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret", signArgs));
// 半角逗号分隔，最多100个
params.put("openIds", "要查询的多个用户的开放用户ID");
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}
