weixin4j/weixin4j-qy/README.md
2015-03-08 16:58:04 +08:00

3.1 KiB

weixin4j-qy

微信企业号开发工具包

功能列表

  • 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-baseweixin4j-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-apiweixin4j-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: 新增邀请成员关注接口
  • 2015-03-08

    • weixin4j-qy-api: 新增根据code获取成员信息接口