企业部门 最后更新时间: 2024年08月30日
产品介绍
该 API 是通过 HTTPS 协议访问远程服务的接口，提供修改组织信息、添加/移除组织成员、修改组织成员信息的能力。
使用限制
详细的服务调用量限制可点我查阅。
业务身份和业务签名
bizToken和bizSign的详情可点我查阅 。
使用说明
如无特殊声明，接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。
1. 创建部门
请求地址
特别注意：
- 一个部门下最多创建1000个直接子部门。
- 创建部门层级最多为20。
- 一个企业下部门名称不允许重复。
请求参数
示例代码（以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/dept/create";
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("name", "新创建的部门");
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}
返回参数
状态码code
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/dept/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("deptId", "部门ID");
params.put("name", "修改后的部门名称");
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}
返回参数
状态码code
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/dept/delete";
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("deptId", "部门ID");
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}
返回参数
状态码code
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/dept/batchUserToDept";
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("deptId", "部门id");
// 部门员工列表为字符串用逗号拼接 示例："NF9FwCBG-fUb9x53SsAGNSSI1zuGRsYywq5NZ347r64,Fp7qQlsQ-B5AqsE5__jS0KAb8o2m2EJOpT0lYGp09zE"
// empId不是openId 分页获取部门的子部门列表和员工列表接口获取empId
params.put("empIds", "员工ID列表");
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}
返回参数
状态码code
5. 设置员工部门
请求地址
特别注意：
- 用户最多加入10个部门。
- 该操作以用户输入的部门列表为最终结果，表示用户加入的部门列表。即用户之前加入的但本次未设置，则会从之前加入的部门退出。
请求参数
示例代码（以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/dept/userFinalToDepts";
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));
// empId不是openId 分页获取部门的子部门列表和员工列表接口获取empId
params.put("empId", "员工ID");
// 部门ID列表为字符串用逗号拼接 示例："xFhUorC-IBW_1LQ9TSA56nzMsaaFYlTDq7ou0fsYy6Q,xFhUorC-IBW_1LQ9TSA56vDV3TGj4DOErbaLjW1aXfg"
params.put("deptIds", "部门ID列表");
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}
返回参数
附表
6. 获取用户部门列表
请求地址
特别注意：暂无。
请求参数
示例代码（以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/dept/getDeptsForUser";
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);
}
返回参数
状态码code
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/dept/getDeptInfo";
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("deptId", "部门ID");
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}
返回参数
状态码code
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/dept/pageGetDepts";
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("deptId", "部门ID");
// 这里传分页的大小 例如10
params.put("limit", 10);
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}
返回参数
状态码code
9. 分页获取部门的子部门列表和员工列表
请求地址
特别注意：暂无。
请求参数
示例代码（以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/dept/pageGetDeptsAndEmps";
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("deptId", "部门ID");
// 这里传分页的大小 例如10
params.put("limit", 10);
String response = MyHttpUtils.postFormUrlencoded(url, params);
System.out.println(response);
}
返回参数
状态码code
对象实体信息定义
DeptInfoDTO
DeptLinkElementDTO
DeptPageResultDTO
DeptAndEmpPageResultDTO
EmpInfoDTO
