109 lines
3.1 KiB
Markdown
109 lines
3.1 KiB
Markdown
weixin4j-qy
|
|
===========
|
|
|
|
[微信企业号](http://qydev.weixin.qq.com/wiki/index.php)开发工具包
|
|
---------------------------------------------------------------
|
|
|
|
功能列表
|
|
-------
|
|
* **weixin4j-qy-api**
|
|
|
|
+ DepartApi `部门管理API`
|
|
|
|
+ UserApi `成员管理API`
|
|
|
|
+ TagApi `标签管理API`
|
|
|
|
+ MediaApi `多媒体管理API`
|
|
|
|
+ MenuApi `菜单管理API`
|
|
|
|
+ NotifyApi `消息发送API`
|
|
|
|
* **weixin4j-qy-server**
|
|
|
|
+ `netty服务器` & `消息分发`
|
|
|
|
+ 回调连接`AES`加密、解密
|
|
|
|
项目说明
|
|
-------
|
|
1.`weixin4j-qy`包含「微信企业号」的API封装以及一个半成品的netty服务实现.
|
|
|
|
2.API的成功调用依赖于正确的appid等数据,创建(或者copy项目里面的)一个名为**weixin.properties**的资源文件放在自己工程中的classpath下.
|
|
|
|
| 属性名 | 说明 |
|
|
| :---------- | :-------------- |
|
|
| account | 微信企业号信息 `json格式` |
|
|
| token_path | 使用FileTokenHolder时token保存的物理路径 |
|
|
| media_path | 调用媒体接口时保存媒体文件的物理路径 |
|
|
|
|
示例(properties中换行用右斜杆\\)
|
|
|
|
account={"id":"corpid","secret":"corpsecret",\
|
|
"token":"企业号中应用在回调模式下的token",\
|
|
"encodingAesKey":"企业号中应用在回调模式下AES加密密钥"}
|
|
|
|
token_path=/tmp/weixin/token
|
|
media_path=/tmp/weixin/media
|
|
|
|
3.在项目根目录执行`mvn package`命令后得到jar包,将`weixin4j-qy-full`包或者`weixin4j-base`跟`weixin4j-qy-api`两个包引入到自己的工程内.
|
|
|
|
WeixinProxy weixinProxy = new WeixinProxy();
|
|
// weixinProxy = new WeixinProxy(corpid,corpsecret);
|
|
// weixinProxy = new WeixinProxy(weixinAccount);
|
|
weixinProxy.getUser(userid);
|
|
|
|
4.如需使用netty服务,则可以在相应的action中实现自己的业务处理,打包后放到`正确的目录`下解压`weixin-qy-server-bin.zip`执行`sh startup.sh start`便可启动服务.
|
|
|
|
@ActionAnnotation(msgType = MessageType.text)
|
|
public class TextAction extends AbstractAction<TextMessage> {
|
|
|
|
@Override
|
|
public ResponseMessage execute(TextMessage inMessage) {
|
|
return new ResponseMessage(new Text("Hello World!"), inMessage);
|
|
}
|
|
}
|
|
|
|
更新LOG
|
|
-------
|
|
* 2014-11-19
|
|
|
|
+ 得到`weixin4j-qy-api`和`weixin4j-qy-server`工程
|
|
|
|
+ **weixin4j-qy-api**: 新增部门管理接口
|
|
|
|
+ **weixin4j-qy-api**: 新增用户管理接口
|
|
|
|
+ **weixin4j-qy-api**: 新增标签管理接口
|
|
|
|
* 2014-11-23
|
|
|
|
+ **weixin4j-qy-api**: 新增`多媒体管理`接口
|
|
|
|
+ **weixin4j-qy-api**: 新增`发送消息`接口
|
|
|
|
+ **weixin4j-qy-api**: 新增`菜单管理`接口
|
|
|
|
* 2014-11-24
|
|
|
|
+ **weixin4j-qy-server**: 新增netty服务与消息分发
|
|
|
|
* 2014-12-28
|
|
|
|
+ **weixin4j-qy-api**: 增加用户进入应用的callback事件
|
|
|
|
+ **weixin4j-qy-api**: 增加批量获取用户详情的接口
|
|
|
|
+ **weixin4j-qy-api**: 新增获取微信服务器IP接口
|
|
|
|
+ **weixin4j-qy-server**: 调整回调模式下的首次验证的签名方式
|
|
|
|
* 2015-01-04
|
|
|
|
+ **weixin4j-qy-api**: 新增批量删除员工接口
|
|
|
|
* 2015-01-15
|
|
|
|
+ **weixin4j-qy-api**: 新增邀请成员关注接口
|