企业微信API简易教程
如何创建一个与企业后台互动的自建应用
添加自建应用
- 登录企业微信管理后台->应用管理->自建下创建应用,填写必要的logo,应用名称,在可见范围中选择部门/成员
- 获取应用的相关信息agentid和secret;应用里
- 创建完毕可出现在选择了可见范围的成员的企业微信终端上。
使用Postman调试api
以发消息为例说明如何调试api接口
调用api的过程,其实就是发送http请求给企业微信后台,在正式开发前,我们可以使用postman模拟http请求调试api。
请求方式:POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN
- 获取Secret
- 获取access_token
access_token是应用调用api的凭证,由corpid和corpsecret换取
请求方式:GET(HTTPS)
请求URL:https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
3. 构造消息体(注意是什么请求方式)
可发送文本、图片、视频等多种类型的应用消息,这里以最简单的文本消息为例:(注意修改touser、agentid为自己想要的接收者userid列表、应用id)
{
"touser": "HuangLong",
"msgtype": "text",
"agentid": 1000002,
"text": {
"content": "你的快递已到,请携带工卡前往邮件中心领取。\n出发前可查看<a href=\"http://work.weixin.qq.com\">邮件中心视频实况</a>,聪明避开排队。"
},
"safe": 0,
"enable_id_trans": 0,
"enable_duplicate_check": 0,
"duplicate_check_interval": 1800
}
- 发送消息
如下图示,以上面两步得到的access_token和消息体为参数,在postman中发送post请求即可
如果发送成功,在接收者的企业微信中的相应应用里,会收到一条文本消息。