Sign inSign up

kukudemajia/qywx_api

By kukudemajia

Updated over 5 years ago

企业微信 最简单的企业微信API The most simplest Wechat API

Image
13

10K+

kukudemajia/qywx_api repository overview

版本说明:

20210126 增加图文消息(包含news、mpnews) 详情 https://work.weixin.qq.com/api/doc/90000/90135/90236 ,同时response信息中增加了version、buildtime两项,便于区别版本。
20210122 仅支持文本消息

使用说明:

首先你得有企业微信 https://work.weixin.qq.com/help?doc_id=13312
企业微信消息类型的官方说明:https://work.weixin.qq.com/api/doc/90000/90135/90236

注意: 环境变量参数不需要加引号

QYWX_AGENTID、QYWX_SECRET不同参数之间用逗号分开,参数num是指你要发给第几个应用
比如num=1就是采用你的AGENTID1以及你的SECRET1发送信息,以此类推。

必选参数:

QYWX_SECRET_KEY 环境变量中设置,自定义安全码(内容随自己意设置),字数和符号不限,不过建议数字和字母组合,字数过长或者特殊字符暂未完全测试过
QYWX_CORPID 环境变量中设置,登陆企业微信后台https://work.weixin.qq.com/ 获取企业ID
QYWX_AGENTID 环境变量中设置,登陆企业微信后台https://work.weixin.qq.com/ 应用管理中获取AgentId
QYWX_SECRET 环境变量中设置,登陆企业微信后台https://work.weixin.qq.com/ 应用管理中获取Secret msgtype 20210126版本开始支持,可选值分别为1(文本);2(图文news);3(图文mpnews)
key 20210126版本开始支持,需要与QYWX_SECRET_KEY相同,否则判定为非法信息无法发送
num 指你要发送消息给第几个应用,比如num=1就是采用你的AGENTID1以及你的SECRET1发送信息
touser 发送信息的对象,如不明白可以设置为@all即全员发送
content 消息内容,文本模式下最长不超过2048个字节,图文模式下不超过512个字节,超过会自动截断
media_id (图文mpnews)需要设置的参数,即 图文消息缩略图的media_id, 可以通过素材管理接口获得。(文本)、(图文news)不需要设置 可选参数:
title 标题,如没有设置,默认为‘’最新消息‘’,不超过128个字节,超过会自动截断
picurl (图文news)消息中设置的图片网址
redirect_url (图文news)、(图文mpnews)设置的跳转网址

docker run -d --name qywx_api \
  -e QYWX_SECRET_KEY=你的QYWX_SECRET_KEY \
  -e QYWX_CORPID=你的CORPID \
  -e QYWX_AGENTID=你的AGENTID1,你的AGENTID2,你的AGENTID3 \
  -e QYWX_SECRET=你的SECRET1,你的SECRET2,你的SECRET3 \
  -p 5005:5005 \
  --restart=always \
  kukudemajia/qywx_api  
发送信息的例子如下:
GET(图文news)
http://192.168.0.11:5005/wechat?msgtype=2&key=安全码&num=1&touser=@all&title=标题&content=内容&picurl=http://inews.gtimg.com/newsapp_ls/0/13080271776_640330/0&redirect_url=https://new.qq.com/rain/a/20210124A09NNC00  
POST(文本)
curl -H "Content-Type:application/json" -X POST --data '{"msgtype": "1","key": "安全码","num": "1","touser": "@all","title": "标题","content": "内容 "}' http://192.168.0.11:5005/wechat  

Tag summary

Content type

Image

Digest

Size

23.7 MB

Last updated

over 5 years ago

docker pull kukudemajia/qywx_api