[本文所描述的内容具有一定的时效性,请以实际开发所处环境为准]
迟到一天,非常抱歉,今天我们来讲解微信企业号中通讯录的管理。相比于其他微信公众号,企业号的通讯录功能是特殊存在的,它对应于我们企业内部实际的上下级关系。当然,作为一个管理工具,我们也可以将它为我们所用,而忽略这种限制。
-------------------------------------------------------------------------------------------------------------------------------------
正文开始:
在通讯录管理这部分中,我们发现其下的大部分功能实现都是类似的,因此,我们在此只给出一个部门创建的实例。希望各位读者能够自行举一反三,原理其实是一模一样的,就只有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