README.md
开发中...
部门、成员、标签、自定义菜单、Oauth2 接口均可以在开发环境调试
企业号对应多个管理组,请前往 设置
=> 权限管理
任意创建一个管理组,在管理组最下角即可获取 CorpID Secret
有问题请及时提issue
gem "qy_wechat_api", git: "https://github.com/lanrion/qy_wechat_api.git"
暂未对access_token做缓存处理,为了确保在开发过程不会出现token过期问题,请不要使用全局变量存储group_client。
b211efbaa102f4ca6480f75339d85a172cd3298b#">基本用法
请务必结合:http://qydev.weixin.qq.com/wiki/index.php 理解以下API参数使用。
b211efbaa102f4ca6480f75339d85a172cd3298b#">初始化
group_client = QyWechatApi::Client.new(corpid, corpsecret)
b211efbaa102f4ca6480f75339d85a172cd3298b#">部门
group_client.department.create(name, parent_id, order=nil)
group_client.department.update(id, name, parent_id, order=nil)
group_client.department.delete(id)
group_client.department.list
b211efbaa102f4ca6480f75339d85a172cd3298b#">成员
group_client.user.create(user_id, name, options={})
group_client.user.update(user_id, options={})
group_client.user.delete(user_id)
group_client.user.get(user_id)
group_client.user.simple_list(department_id, fetch_child=nil, status=nil)
b211efbaa102f4ca6480f75339d85a172cd3298b#">标签
group_client.tag.create(name)
group_client.tag.update(id, name)
group_client.tag.delete(id)
group_client.tag.get(id)
group_client.tag.add_tag_users(id, user_ids)
group_client.tag.delete_tag_users(id, user_ids)
group_client.tag.list
b211efbaa102f4ca6480f75339d85a172cd3298b#">自定义菜单
menu_json的生成方法请参考: https://github.com/lanrion/weixin_rails_middleware/wiki/DIY-menu
group_client.menu.create(menu_json, app_id)
group_client.menu.delete(app_id)
group_client.menu.get(app_id)
Oauth2用法
先要配置你应用的 可信域名 2458023e.ngrok.com
state 为开发者自定义参数,可选
# 生成授权url
group_client.oauth.authorize_url("http://2458023e.ngrok.com", "state")
# 获取code后,获取用户信息
# app_id: 跳转链接时所在的企业应用ID
group_client.oauth.get_user_info("code", "app_id")