添加自建运用
登录企业微信管理端 -> 运用与小程序 -> 运用 -> 自建,点击“创建运用”,设置运用logo、运用名称等信息,创建运用。创建完成后,在管理真个运用列表里进入该运用,可以看到agentid、secret等信息,这些信息在利用企业微信API时会用到。创建完成后,该运用会自动涌如今可见范围内的成员的企业微信终端上(包括手机端、pc端、微信插件)
利用工具调试api我们已经创建好一个自建运用,且拿到了可用的运用id及secret,如何调用api掌握这个运用呢?下面以发为例解释如何调试api接口。
调用api的过程,实质上便是发送http要求给企业微信后台,在正式开拓前,我们可以利用工具仿照http要求调试api。这里以 postman 为例(下载地址,利用方法略),当然你也可以利用其它http仿照工具。

发api见发送运用,可以看到实在便是一个post要求
要求办法:POST(HTTPS)要求地址: https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN
post 参数为 access_token 和 体。
1.获取access_token
参考开始开拓,access_token是运用调用api的凭据,由 corpid和corpsecret换取。
要求办法:GET(HTTPS)要求URL:https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
利用postman发送这样一个GET要求即可得到access_token(请把截图中的corpid、corpsecret换为自己的corpid、运用secret)
2.布局体
参考发送运用,可以发送文本、图片、视频等多种类型的运用,这里以最大略的文本为例:(把稳修正touser、agentid为自己想要的吸收者userid列表、运用id)
{ "touser" : "abelzhu|ZhuShengben", "msgtype" : "text", "agentid" : 1000002, "text" : { "content" : "我就试一下" }, "safe":0}
3.发送
如下图示,以上面两步得到的access_token和体为参数,在postman中发送post要求即可(赤色箭头所指为须要把稳的点)
如果发送成功,在吸收者的企业微信中的相应运用里,会收到一条文本。
实际上,企业微信供应了一套更方便的仿照工具,见开拓者工具的“接口调试工具”。
debug模式调用接口在开拓过程中,可能由于你调用的参数有问题,我们的接口会返回errcode, 此时你可以在“全局缺点码解释”查阅相应的缺点缘故原由。有时候可能根据缺点码解释你仍旧不知道自己的参数在哪里出错,这时候你可以在接口要求url里加上debug=1参数(暂未支持微盘干系接口),之后从接口返回的errmsg复制出hint值,再用以下工具进行查询,我们会返回你要求的完全参数(包括header与body)。
要求示例:https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN&debug=1
查询页面:https://open.work.weixin.qq.com/devtool/query
把稳: debug模式有利用频率限定,同一个api每分钟不能超过5次,以是在完成调试之后,请记得要去掉debug=1参数。
利用php版本demo开始开拓为体验以代码的办法调用api的乐趣,下面以php开拓措辞为例,开拓者需有一定的php根本。
从github下载示例代码。可以看到代码构造为:
├── api // API 接口│ ├── datastructure // API接口须要利用到的一些数据构造│ ├── examples // API接口的测试用例│ ├── README.md│ └── src // API接口的关键逻辑├── callback // 回调的一些方法├── config.php // 根本配置├── README.md└── utils // 一些根本方法
在 api/example/ 路径下,有个 config.php 文件,用于配置自己的企业id、运用id等信息。
如下图所示,修正 CORP_ID、APP_ID、APP_SECRET 为自己的企业信息。
在 api/example/ 路径下,有个发送的示例 MessageTest.php ,如下图所示,修正 touser(发送给的成员id列表)、toparty(发送给的部门id列表)、totag(发送给的标签id列表)等参数为自己的企业的信息。
实行 MessageTest.php 即完成发送(调试期间建议在根目录的 config.php 文件里,配置DEBUG参数为true,如果有失落败,会打印缺点信息)。如果发送成功,吸收者的运用里会收到一条。
利用运用菜单
要实现这样的大略功能:用户点击运用菜单后,展现一个静态网页,奉告企业后台系统的内存利用情形。
须要利用Apache搭建企业后台做事,请自行配置好php和Apache环境。
支配运用后台我们须要在自己的做事器掩护一个页面。以常用的 Apache + php 为例,搭建一个大略的企业后台。在 Apache 的 website 目录下,创建一个页面 getmemoryusage.php,该文件内容如下:
<?phpecho "system memory usage " . memory_get_usage() . "B\n";?>
页面非常大略,通过系统函数获取内存利用情形,并打印出来。这个页面的地址为 http://ip:port/getmemoryusage.php (如何得到ip、port,请参考Apache文献,此处不详述)如果有精确配置 Apache 做事,在当前浏览器里输入 http://ip:port/getmemoryusage.php ,可以看到页面。如何让这个页面在企业微信运用中展现呢?
配置运用菜单在管理端进入上面创建好的自建运用,点击“自定义菜单”项,菜单名自取,菜单内容选“跳转到网页”,URL填上 http://ip:port/getmemoryusage.php ,保存并发布,即完成了添加运用菜单的过程。
运用菜单发布后,从企业微信终端进入该运用,可以看到菜单已经更新。点击菜单即可看到企业后台系统的内存利用情形了!
把稳,上面的URL在真实利用时必须外网可访问。如果只是用于测试,外网不可访问,那么测试的终端必须与页面所在做事器在同一个网段,或者利用内网穿透工具(如花生壳)。
以长进程只是建立了一个非常大略的运用。企业微信供应了多达近200个api,开拓者可以利用这些api实现更多丰富多彩的功能。