[本文所描述的内容具有一定的时效性,请以实际开发所处环境为准]
迟到一天,非常抱歉,今天我们来讲解微信企业号中通讯录的管理。相比于其他微信公众号,企业号的通讯录功能是特殊存在的,它对应于我们企业内部实际的上下级关系。当然,作为一个管理工具,我们也可以将它为我们所用,而忽略这种限制。
-------------------------------------------------------------------------------------------------------------------------------------
正文开始:
在通讯录管理这部分中,我们发现其下的大部分功能实现都是类似的,因此,我们在此只给出一个部门创建的实例。希望各位读者能够自行举一反三,原理其实是一模一样的,就只有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);
}
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("操作失败");
// }
// }
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
至此,微信企业号开发(4)--管理通讯录(部门)结束。
特别说明:
虽然微信相关开发的文档满天飞,博主所写的也不是优秀的实现。但是如果大家觉得这些文章有意义的话,请静下心来,多花1个小时时间认真理解其中一个的实现过程,后续的开发便会非常容易。谢谢大家!
参考资料:
[1]微信公众平台开发者文档:http://mp.weixin.qq.com/wiki/home/index.html
[2]企业号开发者接口文档:http://qydev.weixin.qq.com/wiki/index.php?title=%E9%A6%96%E9%A1%B5