微信企业号开发教程之管理通讯录

2017年11月11日 10:23 | 2722次浏览

在通讯录管理这部分中,我们发现其下的大部分功能实现都是类似的,因此,我们在此只给出一个部门创建的实例。希望各位读者能够自行举一反三,原理其实是一模一样的,就只有POST数据不同而已,所以请不要偷懒哦。

  1. 首先,来看企业号官方文档对创建部门的要求


惯例,重点内容,我们在回顾一遍:

http方法:POST

url地址:https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token=ACCESS_TOKEN

参数格式:JSON数据。是否必须,见上图。

2.首先,我们来看看Java如何将我们的参数封装成上述需求的函数。这里请大家注意,我们的代码请尽可能的包含有用的注释,这样在使用的时候便不用反复寻找方法调用的规范等,养成良好的代码规范,才能更好的在团队协作中,合作共赢。

	/**
	 * 创建部门
	 * @param name 部门名称。长度限制为1~64个字符
	 * @param parentid 父亲部门id。根部门id为1
	 * @param order 在父部门中的次序值。order值小的排序靠前。
	 * @param id 部门id,整型。指定时必须大于1,不指定时则自动生成
	 * */
	public String createDepartment(String name , String parentid,String order,String id){
		String Postjson = "{\"name\": %s,\"parentid\": %s,\"order\": %s,\"id\": %s}";
		return String.format(Postjson, name,parentid,order,id);
	}
	//V型知识库 www.vxzsk.com

3.有了数据封装函数,现在就可以调用微信的接口了。这里我们需要使用到微信企业号开发(2)--建立连接(主动)中的HttpRequest方法,在此,我们就不再写出这段代码,想要这部分代码的同学请翻看上面的这篇博文。

4.最后我们在给出单元测试的伪代码。注意,我们的URL都是默认大家已经正确填写,AccessToken也是正确获取的,获取方式同样请参见上文中AccessToken的获取

//示例
//	public static void main(String[] args) {
//		/**
//		 * 创建部门示例
//		 * */
//		// 调取凭证
//		//参见微信企业号开发(2)
//		// 拼装数据
//		String PostData = createDepartment("新建部门", "2","可以省略","可以省略");
//		// 提交数据,获取结果
//		//调用HttpRequest方法。
//		// 打印结果
//		if(0==result){
//			System.out.println("操作成功");
//		}
//		else {
//			System.out.println("操作失败");
//		}
//	}

5.运行测试main方法之后,应该能够看到微信后台对我们的服务请求给出的返回结果。如果发生错误,请大家参照企业号开发者接口文档中全局返回码的错误进行修改即可


参考资料 

企业号开发者接口文档:http://qydev.weixin.qq.com/wiki/index.PHP?title=%E9%A6%96%E9%A1%B5



小说《我是全球混乱的源头》

感觉本站内容不错,读后有收获?小额赞助,鼓励网站分享出更好的教程