C++微信网页协议实现和应用

清疚 2023-06-02 07:55 12阅读 0赞

**微信推送报警消息实现**

1      前言... 2

1.1     背景... 2

1.2     现有技术对比... 2

2      总体流程... 2

3      微信网页接口解析... 3

3.1     获取用户uuid. 3

3.2     获取二维码图片... 4

3.3     轮询检测用户是否登录... 4

3.4     重定向url登录微信并获取公参... 5

3.5     微信初始化... 5

3.6     获取联系人列表... 11

3.7     批量获取联系人详情... 13

3.8     检测是否有微信消息... 16

3.9     获取最新消息... 17

3.10       通过微信推送报警消息... 22

3.11       上传文件到微信服务器... 24

3.12       发送图片... 27

4      一些状态码code值的说明... 28

4.1     BaseResponse里的Ret 28

4.2     同步消息检查返回值中retcode和selector 28

4.3     返回消息类型... 29

5      实现操作步骤... 30

6      技术制约... 32

7      技术应用推广... 32

# 1       前言 #

## 1.1  背景 ##

微信已经普遍被大家应用，而且手机微信方便快捷，可以随时随地的接受消息。目前项目中有需求通过微信推送报警消息。但是微信没有对外接口，无法实现报警推送。微信的方便快捷没有办法使用。可以通过微信的网页接口来实现微信的登录、获取好友信息、发送微信消息、获取微信消息等；

## 1.2  现有技术对比 ##

现有的技术主要是通过电脑客户端、或者手机客户端去接收报警，电脑客户端只能在电脑上查看，不够方便快捷。而手机客户端需要开发对应手机系统的app，还要经过复杂的传输协议。开发周期长，实现复杂。而且需要安装特定的app才可以接收报警。报警接收和发送不够方便快捷。而通过微信的网页端口去推送报警，可以实现报警的方便推送，报警可以发到微信用户、微信群、微信公众号。

# 2       总体流程 #

微信网页接口的调用流程如图2-1所示，

（1）   首先要获取用户UUID，用标识一个用户；

（2）   然后将UUID作为参数，获取用户登录扫描的二维码，然后等待用户去扫描二维码；

（3）   用户扫描之后，二维码变成用户的头像；轮循去查看用户是否点击登录按钮；

（4）   用户登录之后，会返回一个重定向的URL，作为用户的登录URL；

用URL去登录微信服务器，返回用户的key值、用户id、用户标识id、cookie

（5）   调用初始化的接口，初始化微信主界面，首页用户信息，登录用户自己的用户信息，检测是否有人发消息过来的键值组。每个键值针对不同的消息；

（6）   获取所有好友、微信群、公众号的信息；

（7）   查询服务器是否有微信消息发给登录用户，包括微信通讯消息，好友修改备注消息等。解析消息协议，显示在窗口中；

（8）   指定用户发送微信消息；也可以将报警消息通过微信发送接口进行发送；

图2-1 微信接口调用流程

# 3       微信网页接口解析 #

## 3.1  **获取用户****uuid** ##

*  **说明**：用于获取显示二维码以及登录所需的**uuid**，标识获取二维码和扫码的为同一个用户
 *  **请求方式**：GET
 *  **地址**：https://login.wx.qq.com/jslogin?appid=wx782c26e4c19acffb&fun=new&lang=zh\_CN
 *  **get****参数**：
 *

<table style="width:0px;"> 
 <tbody> 
 <tr> 
 <td> 参数 </td> 
 <td> 示例值 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> appid </td> 
 <td> wx782c26e4c19acffb </td> 
 <td> 固定值 </td> 
 </tr> 
 <tr> 
 <td> fun </td> 
 <td> new </td> 
 <td> 固定值 </td> 
 </tr> 
 <tr> 
 <td> lang </td> 
 <td> zh_CN </td> 
 <td> 表示中文字符集 </td> 
 </tr> 
 </tbody> 
</table>

*  **返回**：

window.QRLogin.code = 200; window.QRLogin.uuid = "wb7R2kx9dA==";

## 3.2  **获取二维码图片** ##

*  **说明**：展示一张用于登陆的二维码图片，地址里的**\{uuid\}**传第一步所获取的**uuid**
 *  **请求方式**：GET
 *  **地址**：[https://login.wx.qq.com/qrcode/\{uuid\}][https_login.wx.qq.com_qrcode_uuid]
 *  **get****参数**：
 *

*  **返回**：二维码的二进制流，浏览器打开会直接显示一张二维码图片，客户端需要保存到本地文件，然后用label加载显示；

## 3.3  **轮询检测用户是否登录** ##

*  **说明**：尝试登录。若此时用户手机已完成扫码并点击登录，则返回一个真正用于登录的**url**地址。否则接口大概10s后返回未扫码或未登录的状态码
 *  **请求方式**：GET
 *  **地址**：[https://login.wx.qq.com/cgi-bin/mmwebwx-bin/login][https_login.wx.qq.com_cgi-bin_mmwebwx-bin_login]
 *  **get****参数**：
 *

<table style="width:0px;"> 
 <tbody> 
 <tr> 
 <td> 参数 </td> 
 <td> 示例值 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> tip </td> 
 <td> 1 </td> 
 <td> 1：未扫描 &nbsp; 0：一扫描 </td> 
 </tr> 
 <tr> 
 <td> uuid </td> 
 <td> wb7R2kx9dA== </td> 
 <td> 第一步所获取的uuid </td> 
 </tr> 
 </tbody> 
</table>

*  **返回**：redirect\_uri的值可以直接用于下一步的“登录并获取公参”请求

window.code=200（408为未扫码，201为已扫码但未点击登录，200为成功登录）;**window.redirect\_uri="https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage?ticket=AfrMMbhsnElmA7xc1R9CWUq-@qrticket\_0&uuid=4ZnG7WZ0Cg==&lang=zh\_CN&scan=1520738372";**

## 3.4  **重定向****url****登录微信并获取公参** ##

*  **说明**：访问后可获取一组公参，用于之后访问所有的接口。这也意味着如果这部分数据泄露，代表其他人可以在这段时间内随意操作你的微信（仅限于网页版支持的操作）
 *  **请求方式**：GET
 *  **地址**：[https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage][https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxnewloginpage]
 *  **get****参数**：直接用上一步返回的**redirect\_uri**中的所有参数即可
 *  **返回**：获取并存储该返回值中的四个参数**skey**、**wxsid**、**wxuin**、**pass\_ticket**，返回cookie保存到本地文件中，下面有接口调用时需要带上这个cookie文件。

**返回结果**：

<error> 
　　<ret>0</ret> 
　　<message></message> 
　　<skey>@crypt\_8b4f09cc\_a5871dc10130a48703b9afd5602152e4</skey> 
　　<wxsid>+urBrYI292xoIknf</wxsid> 
　　<wxuin>211722515</wxuin> 
　　<pass\_ticket>qg%2BL%2BfjNnoHyqYsL3xj0KoNi5nqchsInPWWSxDwqCJ8%3D</pass\_ticket> 
　　<isgrayscale>1</isgrayscale> 
</error>

## 3.5  **微信初始化** ##

*  **说明**：初始化微信首页栏的联系人、公众号等（不是通讯录里的联系人），初始化登录者自己的信息（包括昵称等），初始化同步消息所用的SycnKey
 *  **请求方式**：POST
 *  **地址**：[https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxinit][https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxinit]
 *  **get****参数**：
 *

<table> 
 <tbody> 
 <tr> 
 <td> 参数 </td> 
 <td> 示例值 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> pass_ticket </td> 
 <td> qg%2BL%2BfjNnoHyqYsL3xj0KoNi5nqchsInPWWSxDwqCJ8%3D </td> 
 <td> 公参中的值 </td> 
 </tr> 
 </tbody> 
</table>

*  **post****参数：（****json****格式）**

BaseRequest: \{

Uin: 211722515，

Sid: +urBrYI292xoIknf，

Skey: @crypt\_8b4f09cc\_a5871dc10130a48703b9afd5602152e4，

DeviceID: e545297464380306  
上边的DeviceID可以用如下代码生成，每次登录过程中保持一致。String DeviceID = "e" + String.valueOf(new Random().nextLong()).substring(1, 16);

*  **返回**：获取并存储该返回值中的四个参数**skey**、**wxsid**、**wxuin**、**pass\_ticket**，以及所返回Cookie中的**webwx\_data\_ticket**，**webwx\_auth\_ticket**

"BaseResponse": \{

"Ret": 0,

"ErrMsg": ""

\},

"Count": 11,

"ContactList": \[\{微信首页的联系人，不是保存在通讯录中的联系人

"Uin": 0,

"UserName": "filehelper",

"NickName": "文件传输助手",

"HeadImgUrl": "/cgi-bin/mmwebwx-bin/webwxgeticon?seq=680769514&username=filehelper&skey=@crypt\_8b4f09cc\_a5871dc10130a48703b9afd5602152e4",

"ContactFlag": 1,

"MemberCount": 0,

"MemberList": \[\],

"RemarkName": "",

"HideInputBarFlag": 0,

"Sex": 0,

"Signature": "",

"VerifyFlag": 0,

"OwnerUin": 0,

"PYInitial": "WJCSZS",

"PYQuanPin": "wenjianchuanshuzhushou",

"RemarkPYInitial": "",

"RemarkPYQuanPin": "",

"StarFriend": 0,

"AppAccountFlag": 0,

"Statues": 0,

"AttrStatus": 0,

"Province": "",

"City": "",

"Alias": "",

"SnsFlag": 0,

"UniFriend": 0,

"DisplayName": "",

"ChatRoomId": 0,

"KeyWord": "fil",

"EncryChatRoomId": "",

"IsOwner": 0

\},

......此处省略剩下的10个联系人信息

\],

"SyncKey": \{ 同步消息时用的syncKey，用于之后轮询消息的接口

"Count": 4,

"List": \[\{

"Key": 1,

"Val": 700722177

\}, \{

"Key": 2,

"Val": 700723184

\}, \{

"Key": 3,

"Val": 700723136

\}, \{

"Key": 1000,

"Val": 1520723642

\}\]

\},

"User": \{ 登录者的信息

"Uin": 211722515,

"UserName": "@f4c054c78f40743b095b85409dbdc1b3", 微信随机码，每个联系人和群都有，每次登录由微信端随机分配

"NickName": "测试微信号的昵称",

"HeadImgUrl": "/cgi-bin/mmwebwx-bin/webwxgeticon?seq=1730335888&username=@f4c054c78f40743b095b85409dbdc1b3&skey=@crypt\_8b4f09cc\_a5871dc10130a48703b9afd5602152e4",

"RemarkName": "",

"PYInitial": "",

"PYQuanPin": "",

"RemarkPYInitial": "",

"RemarkPYQuanPin": "",

"HideInputBarFlag": 0,

"StarFriend": 0,

"Sex": 1,

"Signature": "这里是签名",

"AppAccountFlag": 0,

"VerifyFlag": 0,

"ContactFlag": 0,

"WebWxPluginSwitch": 0,

"HeadImgFlag": 1,

"SnsFlag": 17

\},

"ChatSet": "filehelper,weixin,@52d5b97ca1bed2d76b405fba4c4ded6c893bd6b28cc514344dd9a7d8cd766286,@4baf3160e84b9e726efd1a0629d16b01,@@54a4fd2c81875aac779935330b67bf7905793bb66da9c6d4029f18f4927b3c1c,@@9542a551bfcafe1ae83b931d21b318573c8c6e2c67f3eaef189e7e9179cdb2d1,@ac3532106e21aa250cc746055a0c72d5,@d593e5745931641d060cdc9fcda5d996,@34f12e07290f62677137181998bf4c1eb0a9c128f2355562e8cc7967d0f9a044,@@31e445167b2fd23404b672f6f1a4a805fffbd369d6bae8efe959240a6c50cf46,@@c5fa6cb3779e217b5ae3e9b3d53faef09d6cde9615106ebe0a115de38976c7fc,@513fcb83ccc696b9d90206f0e80eb8e341e35e1f464b08446795132d180db040,@@b944058f6fd91b850867bb1f534205e86460b4b3a947f4ca4bd49109e532116f,@@859e98412d1faf03abdf784e97ed66b25c52dccc7ec446d681b2906525262fcd,@257fb1c805c1429ca45a737143d7a7e1302487d9bbb268bf2dd8a564bf814186,filehelper,@@dc3e7f04b1ccead2ecf8c50eaa476d6c71dc3f7396696be0724002e1ee228812,@@d1758feb60b1ff7ad262b8fb05ee9f1c1821722a0376a1431cee351c75cbebc3,@@e49ba13661221be9c9f81fb952391754ee74f98d2457f46364bdb745943b2bfc,@@a5cdd9eb797807cc081bc0e3ab3f101c9dc18d86d527c5defed8e8fd9010ec06,@@dfab3cde2a39ccdf31da803381528f130dae207583a5c088514bf4e1a0af49ab,@@13776e6ea475a8e86a46e4f242917db146664572e910dcca976047cb31e660f4,@@d1999c210e6f9a19d28b4a8fcc391a7b612c9765ff5bd078aaa022e1cc8bbf5c,",

"SKey": "@crypt\_8b4f09cc\_ce5178b3c156048fff69cdf1fccc31e4",

"ClientVersion": 637927733,

"SystemTime": 1520742050,

"GrayScale": 1,

"InviteStartCount": 40,

"MPSubscribeMsgCount": 1,

"MPSubscribeMsgList": \[\{

"UserName": "@4baf3160e84b9e726efd1a0629d16b01",

"MPArticleCount": 1,

"MPArticleList": \[\{

"Title": "不动手就能逛淘宝，这又是什么“黑科技”？英国小哥表示：中文说得溜就是这么方便！ | 解码新时代",

"Digest": "张口说话就能逛淘宝，沉溺“黑科技”的英国小哥表示不想回家了！",

"Cover": "http://mmbiz.qpic.cn/mmbiz\_jpg/8vd2Hk2TS2Pfibh9ILZKicg5icBlWKHBIVibVM8Vupsg3NsfSnibzptB9XQxArqzFmfOw7nlk6ByTdNvWBoBf4NjVmQ/640?wxtype=jpeg&wxfrom=0",

"Url": "http://mp.weixin.qq.com/s?\_\_biz=MjM5MzI3NTI2MA==&mid=2651224106&idx=1&sn=0a5772013ae7c14dd9ac854f30fad934&chksm=bd6b54398a1cdd2f6f9c1d61c93aa3248968b8b56206a0af85341f510322b21548c975d8ebba&scene=0\#rd"

\}\],

"Time": 1520732033,

"NickName": "中国日报双语新闻"

\}\],

"ClickReportInterval": 600000

## 3.6  **获取联系人列表** ##

*  **说明**：获取手机通讯录中的所有联系人（包括人、群、公众号等）
 *  **请求方式**：POST
 *  **地址**：[https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetcontact][https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxgetcontact]
 *  **get****参数**：
 *

<table> 
 <tbody> 
 <tr> 
 <td> 参数 </td> 
 <td> 示例值 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> pass_ticket </td> 
 <td> yp5RfCpb%2FsNVex0Uepn1BWXNCYCqTfqe8NOYzan%2B4Y4%3D </td> 
 <td> 公参中的值 </td> 
 </tr> 
 <tr> 
 <td> skey </td> 
 <td> @crypt_8b4f09cc_1b827f84b1535b6be801f00427499050 </td> 
 <td> 公参中的值 </td> 
 </tr> 
 </tbody> 
</table>

*  **post****参数：**

"BaseRequest": \{均是公参中的值

"Uin": 211722515,

"Sid": "+FhlgkGS3wD/GKQw",

"Skey": "@crypt\_8b4f09cc\_1b827f84b1535b6be801f00427499050",

"DeviceID": "e609547902722302"

*  **返回**：所有通讯录中的联系人信息，主要在MemberList中查看

"BaseResponse": \{

"Ret": 0,

"ErrMsg": ""

\},

"MemberCount": 771,

"MemberList": \[\{

"Uin": 0,

"UserName": "@9c30c8d81e75a7eff0603cdd5de860b18fe92995845473fc2f0cda6ed76053cb",（微信随机码，潜规则：前面@为联系人，@@为群）

"NickName": "Nandi Wardhana",（联系人的微信昵称）

"HeadImgUrl": "/cgi-bin/mmwebwx-bin/webwxgeticon?seq=620986971&username=@9c30c8d81e75a7eff0603cdd5de860b18fe92995845473fc2f0cda6ed76053cb&skey=@crypt\_8b4f09cc\_1b827f84b1535b6be801f00427499050",

"ContactFlag": 3,

"MemberCount": 0,（如果是群，该字段表示成员数量）

"MemberList": \[\],（群成员列表）

"RemarkName": "",（备注名称，如果空则说明没有给他备注）

"HideInputBarFlag": 0,

"Sex": 1,（性别，1为男，2为女）

"Signature": "Stay young naturally...",（签名）

"VerifyFlag": 0,（用来判断是否是公众号或服务号的字段）

"OwnerUin": 0,

"PYInitial": "NANDIWARDHANA",

"PYQuanPin": "NandiWardhana",（名字拼音全拼）

"RemarkPYInitial": "",

"RemarkPYQuanPin": "",

"StarFriend": 0,

"AppAccountFlag": 0,

"Statues": 0,

"AttrStatus": 2359303,

"Province": "Jakarta Raya",（省份）

"City": "",（城市）

"Alias": "",

"SnsFlag": 17,

"UniFriend": 0,

"DisplayName": "",（如果是群内成员，该字段表示群内名称）

"ChatRoomId": 0,

"KeyWord": "",

"EncryChatRoomId": "",（如果是群，该字段表示群的id，不同于微信随机码@@那个）

"IsOwner": 0

\},

... 此处省略剩下770个联系人信息

## 3.7  **批量获取联系人详情** ##

*  **说明**：批量获取联系人详情，人或群均可。获取群详情主要是获取群内联系人列表。获取人详情主要是获取群内的某个人的详细信息。
 *  **请求方式**：POST
 *  **地址**：[https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxbatchgetcontact][https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxgetcontact]
 *  **get****参数**：
 *

<table> 
 <tbody> 
 <tr> 
 <td> 参数 </td> 
 <td> 示例值 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> pass_ticket </td> 
 <td> yp5RfCpb%2FsNVex0Uepn1BWXNCYCqTfqe8NOYzan%2B4Y4%3D </td> 
 <td> 公参中的值 </td> 
 </tr> 
 <tr> 
 <td> type </td> 
 <td> ex </td> 
 <td> 我也不知道这是啥意思 </td> 
 </tr> 
 </tbody> 
</table>

*  **post****参数：**

"BaseRequest": \{

"Uin": 211722515,

"Sid": "+FhlgkGS3wD/GKQw",

"Skey": "@crypt\_8b4f09cc\_1b827f84b1535b6be801f00427499050",

"DeviceID": "e862192966399662"

\},

"Count": 2,

"List": \[\{ 这里表示需要获取详情的所有联系人

"UserName": "@@e203c90e07d64242336d573acd4a1db1c01ccb92ca05410444a3003c282c21db",

"EncryChatRoomId": ""

\},

"UserName": "@ba194a63575be7fd0f4ea4e4547b2942d0dccc7fffc00ef5a6d141f93adb7739",

"EncryChatRoomId": ""

*  **返回：**

"BaseResponse": \{

"Ret": 0,

"ErrMsg": ""

\},

"Count": 2,

"ContactList": \[\{

"Uin": 0,

"UserName": "@ba194a63575be7fd0f4ea4e4547b2942d0dccc7fffc00ef5a6d141f93adb7739",

"NickName": "张三丰",

"HeadImgUrl": "/cgi-bin/mmwebwx-bin/webwxgeticon?seq=680786093&username=@ba194a63575be7fd0f4ea4e4547b2942d0dccc7fffc00ef5a6d141f93adb7739&skey=",

"ContactFlag": 3,

"MemberCount": 0,

"MemberList": \[\],

"RemarkName": "丰哥",

"HideInputBarFlag": 0,

"Sex": 2,

"Signature": " 一定会找到",

"VerifyFlag": 0,

"OwnerUin": 0,

"PYInitial": "ZSF",

"PYQuanPin": "zhangsanfeng",

"RemarkPYInitial": "FG",

"RemarkPYQuanPin": "fengge",

"StarFriend": 0,

"AppAccountFlag": 0,

"Statues": 0,

"AttrStatus": 111719,

"Province": "北京",

"City": "平谷",

"Alias": "",

"SnsFlag": 17,

"UniFriend": 0,

"DisplayName": "",

"ChatRoomId": 0,

"KeyWord": "",

"EncryChatRoomId": "0",

"IsOwner": 0

...此处省略第二个联系人信息

## 3.8  **检测是否有微信消息** ##

*  **说明**：同步消息检查。这里只做检查不做同步，如果检查出有新消息，再掉具体同步的接口。
 *  **请求方式**：GET，需要传入获取到的cookie，否则失败
 *  **地址**：[https://webpush2.weixin.qq.com/cgi-bin/mmwebwx-bin/synccheck][https_webpush2.weixin.qq.com_cgi-bin_mmwebwx-bin_synccheck]
 *  **get****参数**：
 *

<table> 
 <tbody> 
 <tr> 
 <td> 参数 </td> 
 <td> 示例值 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> deviceid </td> 
 <td> e547171618594402 </td> 
 <td> 参考5中的生成方式 </td> 
 </tr> 
 <tr> 
 <td> sid </td> 
 <td> +FhlgkGS3wD/GKQw </td> 
 <td> 公参中的值 </td> 
 </tr> 
 <tr> 
 <td> skey </td> 
 <td> @crypt_8b4f09cc_1b827f84b1535b6be801f00427499050 </td> 
 <td> 公参中的值 </td> 
 </tr> 
 <tr> 
 <td> synckey </td> 
 <td> 1_700722177|2_700724323|3_700724315|1000_1520925834 </td> 
 <td> 微信初始化后获取的4个key，这些key会随着每次获取最新消息（参见9）后的返回值更新，其目的在于每次同步消息后记录一个当前同步的状态。 </td> 
 </tr> 
 <tr> 
 <td> uin </td> 
 <td> 211722515 </td> 
 <td> 公参中的值 </td> 
 </tr> 
 </tbody> 
</table>

*  **返回：**

window.synccheck=\{retcode:"0",selector:"2"\}

retcode  
SUCCESS("0", "成功"),  
TICKET\_ERROR("-14", "ticket错误"),  
PARAM\_ERROR("1", "传入参数错误"),  
NOT\_LOGIN\_WARN("1100", "未登录提示"),  
NOT\_LOGIN\_CHECK("1101", "未检测到登录"),  
COOKIE\_INVALID\_ERROR("1102", "cookie值无效"),  
LOGIN\_ENV\_ERROR("1203", "当前登录环境异常，为了安全起见请不要在web端进行登录"),  
TOO\_OFEN("1205", "操作频繁");

selector  
NORMAL("0", "正常"),  
NEW\_MSG("2", "有新消息"),  
MOD\_CONTACT("4", "有人修改了自己的昵称或你修改了别人的备注"),  
ADD\_OR\_DEL\_CONTACT("6", "存在删除或者新增的好友信息"),  
ENTER\_OR\_LEAVE\_CHAT("7", "进入或离开聊天界面");

## 3.9  **获取最新消息** ##

*  **说明**：当同步检查接口显示有新消息时，调用该接口获取具体的新消息。此处的新消息为广义的，包括消息，修改群名，群内成员变化，加好友等。
 *  **请求方式**：POST，需要传入获取到的cookie，否则失败
 *  **地址**：[https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsync][https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxsync]
 *  **get****参数**：
 *

<table style="width:0px;"> 
 <tbody> 
 <tr> 
 <td> 参数 </td> 
 <td> 示例值 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> sid </td> 
 <td> +FhlgkGS3wD/GKQw </td> 
 <td> 公参中的值 </td> 
 </tr> 
 <tr> 
 <td> skey </td> 
 <td> @crypt_8b4f09cc_1b827f84b1535b6be801f00427499050 </td> 
 <td> 公参中的值 </td> 
 </tr> 
 <tr> 
 <td> uin </td> 
 <td> 211722515 </td> 
 <td> 公参中的值 </td> 
 </tr> 
 </tbody> 
</table>

*  **post****参数：**

"BaseRequest": \{

"Uin": 211722515,

"Sid": "+FhlgkGS3wD/GKQw",

"Skey": "@crypt\_8b4f09cc\_1b827f84b1535b6be801f00427499050",

"DeviceID": "e304534670317808"

\},

"SyncKey": \{

"Count": 4,

"List": \[\{

"Key": 1,

"Val": 700722177

\}, \{

"Key": 2,

"Val": 700724323

\}, \{

"Key": 3,

"Val": 700724315

\}, \{

"Key": 1000,

"Val": 1520925834

\}\]

\},

"rr": -508959981  String.valueOf(-new Date().getTime() / 1000)

*  **返回：**主要有AddMsgList，ModContactList，DelContactList，新一轮消息同步的检测消息的键值SyncCheckKey ，新一轮获取消息的synckey

"BaseResponse": \{

"Ret": 0,

"ErrMsg": ""

\},

"AddMsgCount": 1, 新增信息

"AddMsgList": \[\{

"MsgId": "320984672637990367", 服务端返回的消息id，可用于撤回接口参数。如果是图片，该参数还可以作为调用微信获取图片接口的参数之一。

"FromUserName": "@abf90232027117affa7f0c0df3d1bf20", 发消息的人

"ToUserName": "@abf90232027117affa7f0c0df3d1bf20", 发给谁

"MsgType": 51, 消息类型，1为文字，3为图片...，具体请参照消息类型表

"Content": "",

"Status": 3,

"ImgStatus": 1,

"CreateTime": 1520927383,

"VoiceLength": 0,

"PlayLength": 0,

"FileName": "",

"FileSize": "",

"MediaId": "",

"Url": "",

"AppMsgType": 0,

"StatusNotifyCode": 4,

"ForwardFlag": 0,

"AppInfo": \{

"AppID": "",

"Type": 0

\},

"HasProductId": 0,

"Ticket": "",

"ImgHeight": 0,

"ImgWidth": 0,

"SubMsgType": 0,

"NewMsgId": 320984672637990367,

"OriContent": "",

"EncryFileName": ""

\}\],

"ModContactCount": 0, 联系人修改

"ModContactList": \[\],

"DelContactCount": 0, 联系人删除

"DelContactList": \[\],

"ModChatRoomMemberCount": 0, 群内成员变动

"ModChatRoomMemberList": \[\],"ContinueFlag": 0,

"SyncKey": \{ 新一轮消息更新用这些SyncKey

"Count": 7,

"List": \[\{

"Key": 1,

"Val": 700722177

\}, \{

"Key": 2,

"Val": 700724325

\}, \{

"Key": 3,

"Val": 700724315

\}, \{

"Key": 11,

"Val": 700724093

\}, \{

"Key": 201,

"Val": 1520927383

\}, \{

"Key": 1000,

"Val": 1520925834

\}, \{

"Key": 1001,

"Val": 1520917874

\}\]

\},

"SKey": "",

"SyncCheckKey": \{ 新一轮消息检测用这些Key

"Count": 7,

"List": \[\{

"Key": 1,

"Val": 700722177

\}, \{

"Key": 2,

"Val": 700724325

\}, \{

"Key": 3,

"Val": 700724315

\}, \{

"Key": 11,

"Val": 700724093

\}, \{

"Key": 201,

"Val": 1520927383

\}, \{

"Key": 1000,

"Val": 1520925834

\}, \{

"Key": 1001,

"Val": 1520917874

\}\]

## 3.10         **通过微信推送报警消息** ##

*  **说明**：发送文本消息（包括表情），不能发送图片或文件。
 *  **请求方式**：POST，需要传入获取到的cookie，否则失败
 *  **地址**：[https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsg][https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxsendmsg]
 *  **get****参数**：
 *

<table> 
 <tbody> 
 <tr> 
 <td> 参数 </td> 
 <td> 示例值 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> pass_ticket </td> 
 <td> yp5RfCpb%2FsNVex0Uepn1BWXNCYCqTfqe8NOYzan%2B4Y4%3D </td> 
 <td> 公参中的值 </td> 
 </tr> 
 </tbody> 
</table>

*  **post****参数：**

"BaseRequest": \{

"Uin": 211722515,

"Sid": "+FhlgkGS3wD/GKQw",

"Skey": "@crypt\_8b4f09cc\_1b827f84b1535b6be801f00427499050",

"DeviceID": "e107694022625701"

\},

"Msg": \{

"Type": 1,

"Content": "呵呵",

"FromUserName": "@abf90232027117affa7f0c0df3d1bf20",

"ToUserName": "filehelper",

"LocalID": "15209344559450477", 时间戳左移4位随后补上4位随机数

"ClientMsgId": "15209344559450477"  
　　　　　"MediaId": "" 如果是图片才传这个值

\},

"Scene": 0

*  **返回：**

"BaseResponse": \{

"Ret": 0,

"ErrMsg": ""

\},

"MsgID": "7615282929538795099", 服务端返回的消息id，可用于撤回等接口的参数

"LocalID": "15209344559450477" 本地的消息id，是你自己发请求时的参数

## 3.11         **上传文件到微信服务器** ##

*  **说明**：发送图片时需要先调用该接口将图片上传至微信服务器，微信会返回一个图片的id，发送消息时携带该id即可发送图片。
 *  **请求方式**：POST（此处的Content-Type应该设置为multipart/form-data; boundary=…------------------41184676334）
 *  **地址**：[https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxuploadmedia][https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxsendmsg]
 *  **get****参数**：
 *

<table> 
 <tbody> 
 <tr> 
 <td> 参数 </td> 
 <td> 示例值 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> pass_ticket </td> 
 <td> yp5RfCpb%2FsNVex0Uepn1BWXNCYCqTfqe8NOYzan%2B4Y4%3D </td> 
 <td> 公参中的值 </td> 
 </tr> 
 </tbody> 
</table>

*  **post****参数：**

\-----------------------------41184676334

Content-Disposition: form-data; name="id" 此处随意

WU\_FILE\_0

\-----------------------------41184676334

Content-Disposition: form-data; name="name" 图片名称

Desert.jpg

\-----------------------------41184676334

Content-Disposition: form-data; name="type" 图片类型

image/jpeg

\-----------------------------41184676334

Content-Disposition: form-data; name="lastModifiedDate" 发送时间，该参数可无

Tue Jul 14 2009 13:32:31 GMT+0800

\-----------------------------41184676334

Content-Disposition: form-data; name="size" 图片大小

845941

\-----------------------------41184676334

Content-Disposition: form-data; name="chunks" 总共分多少批上传

\-----------------------------41184676334

Content-Disposition: form-data; name="chunk" 当前是第几批

\-----------------------------41184676334

Content-Disposition: form-data; name="mediatype" 当传图片时，此处写pic

pic

\-----------------------------41184676334

Content-Disposition: form-data; name="uploadmediarequest"

\{  
    "UploadType": 2, 固定为2  
    "BaseRequest": \{  
      "Uin": 211722515,  
      "Sid": "+FhlgkGS3wD/GKQw",  
      "Skey": "@crypt\_8b4f09cc\_1b827f84b1535b6be801f00427499050",  
      "DeviceID": "e787605163473377"  
    \},  
    "ClientMediaId": 1520935168955,  
    "TotalLen": 845941, 文件大小  
    "StartPos": 0,  
    "DataLen": 845941, 文件大小  
    "MediaType": 4, 固定为4，表示图片  
    "FromUserName": "@abf90232027117affa7f0c0df3d1bf20", 该参数可填可不填  
    "ToUserName": "filehelper", 该参数可填可不填  
    "FileMd5": "ba45c8f60456a672e003a875e469d0eb" 该参数随机一个uuid即可  
  \}

\-----------------------------41184676334

Content-Disposition: form-data; name="webwx\_data\_ticket"

gSenocajd7UaXQesCD3smJ5p

\-----------------------------41184676334

Content-Disposition: form-data; name="pass\_ticket"

yp5RfCpb/sNVex0Uepn1BWXNCYCqTfqe8NOYzan+4Y4=

\-----------------------------41184676334

Content-Disposition: form-data; name="filename"; filename="Desert.jpg"

Content-Type: application/octet-stream 
 
此处为该文件的流，前端写成<input type="file">就是这个效果

*  **返回：**可能分批次上传，最后上传成功时返回如下结果

"BaseResponse": \{

"Ret": 0,

"ErrMsg": ""

\},  
下面的MediaId参数，作为下一步发送图片接口的入参，就可以发送该图片了

"MediaId": "@crypt\_14402eb3\_bb9eee20e7239fcd3323a0ea5a36cfd5e7fd162b72e03088efa4f63f53219c6f672c6be3ec1865291a70f38bb82bc5bf1d42166996b4a0313abe95454bff0316c19bfd29b71f4f98ccb7d301eed7b74995e35eabfd3f8264a3d684b8e9f08485ad00c3955cdc5b60ac96e67a9ca24bf7a01b9363ae0364f75fa0c9e6235e2dc91aef95b34c71c503deada9898a28ce5bf13d908f7834f7cae427aaba68aff5500125314f73b79f5a63103d430aa162420262e3d1a5e5f110cba0f2ee20017aaf0f127303153dcf63f9e5a56ff8c64f5dfb3f229011374b34fe7a905b0ee055d85b76827e2e68b8947c7b5fcd56c98ede9f012b6160a193762f63842886dca36872727db0c3cd4761af96c56bfdfb0a42630fee9954c764b5cd31f6ff666649b028bb1852366e639e1008cee678d5e587aabbe78014307ae1fbe638e2c0b52115",

"StartPos": 845941,

"CDNThumbImgHeight": 75,

"CDNThumbImgWidth": 100,

"EncryFileName": "Desert.jpg"

## 3.12         **发送图片** ##

*  **说明**：上一步上传文件到微信服务器成功后，调用该发送图片接口。
 *  **请求方式**：POST
 *  **地址**：[https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsgimg][https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxsendmsg]
 *  **get****参数**：
 *

<table> 
 <tbody> 
 <tr> 
 <td> 参数 </td> 
 <td> 示例值 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> pass_ticket </td> 
 <td> yp5RfCpb%2FsNVex0Uepn1BWXNCYCqTfqe8NOYzan%2B4Y4%3D </td> 
 <td> 公参中的值 </td> 
 </tr> 
 <tr> 
 <td> fun </td> 
 <td> async </td> 
 <td> &nbsp; </td> 
 </tr> 
 </tbody> 
</table>

*  **post****参数：**同发文本消息，只是多一个MediaId
 *  **返回：**同发文本消息

**15****、获取图片**

*  **说明**：上一步上传文件到微信服务器成功后，调用该发送图片接口。
 *  **请求方式**：GET
 *  **地址**：[https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsgimg][https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxsendmsg]
 *  **get****参数**：
 *

<table> 
 <tbody> 
 <tr> 
 <td> 参数 </td> 
 <td> 示例值 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> MsgID </td> 
 <td> 3176600141007621447 </td> 
 <td> 服务端返回的消息id </td> 
 </tr> 
 <tr> 
 <td> skey </td> 
 <td> @crypt_8b4f09cc_1b827f84b1535b6be801f00427499050 </td> 
 <td> 公参中的值&nbsp; </td> 
 </tr> 
 <tr> 
 <td> type </td> 
 <td> slave </td> 
 <td> 该参数有则为缩略图，没有则为原图 </td> 
 </tr> 
 </tbody> 
</table>

*  **携带****3****个****cookie****的值：**wxuin，wxsid，webwx\_data\_ticket
 *  **返回：**图片的流

# 4       **一些状态码****code****值的说明** #

## 4.1  **BaseResponse****里的****Ret** ##

SUCCESS("0", "成功"),

TICKET\_ERROR("-14", "ticket错误"),

PARAM\_ERROR("1", "传入参数错误"),

NOT\_LOGIN\_WARN("1100", "未登录提示"),

NOT\_LOGIN\_CHECK("1101", "未检测到登录"),

COOKIE\_INVALID\_ERROR("1102", "cookie值无效"),

TOO\_OFEN("1205", "操作频繁");

## 4.2  **同步消息检查返回值中****retcode****和****selector** ##

retcode

SUCCESS("0", "成功"),

TICKET\_ERROR("-14", "ticket错误"),

PARAM\_ERROR("1", "传入参数错误"),

NOT\_LOGIN\_WARN("1100", "未登录提示"),

NOT\_LOGIN\_CHECK("1101", "未检测到登录"),

COOKIE\_INVALID\_ERROR("1102", "cookie值无效"),

TOO\_OFEN("1205", "操作频繁");

selector

NORMAL("0", "正常"),

NEW\_MSG("2", "有新消息"),

MOD\_CONTACT("4", "有人修改了自己的昵称或你修改了别人的备注"),

ADD\_OR\_DEL\_CONTACT("6", "存在删除或者新增的好友信息"),

ENTER\_OR\_LEAVE\_CHAT("7", "进入或离开聊天界面");

## 4.3  **返回消息类型** ##

TEXT(1, "文本消息类型"),

IMAGE(3, "图片消息"),

VOICE(34, "语音消息"),

VIDEO(43, "小视频消息"),

MICRO\_VIDEO(62, "短视频消息"),

EMOTI\_CON(47, "表情消息"),

MEDIA(49, "多媒体消息"),

VOIP\_MSG(50, ""),

VOIP\_NOTIFY(52, ""),

VOIP\_INVITE(53, ""),

LOCATION(48, ""),

STATUS\_NOTIFY(51, "状态通知，自己访问了某一个聊天页面"),

SYS\_NOTICE(9999, ""),

POSSIBLE\_FRIEND\_MSG(40, ""),

VERIFY\_MSG(37, "好友请求"),

SHARE\_CARD(42, "分享名片"),

SYS(10000, "系统消息"),

RECALLED(10002, "撤回消息");

# 5       实现操作步骤 #

（1）开发QT界面，点击重新登录按钮，下载二维码，等待用户扫描；

![Image 1][]

（2）用手机扫描二维码，登录微信；

登录成功之后，选择要发送的微信用户、文件传输助手、微信群、公众号等。勾选是否推送到微信复选框，表示是否要发送到微信，修改好之后点击保存按钮。默认情况是发给文件传输助手，然后点击测试发送。看是否能够发送成功。心跳发送按钮是每隔一分钟发送一条时间消息，让你知道通讯连接正常，测试用的。没有实际的作用。由于微信的限制，无法自己发给自己，发给文件传输助手、微信群、微信公众号，自己只能显示消息，手机端不会出现屏幕消息提示。所以最好有两个手机账号，一个登陆发送，一个接收消息。因为微信同时只能登录一个网页端或者window的客户端，所以微信登录了之后，不能再去登录网页或者客户端，否则会挤掉登录，导致发送失败。

![Image 1][]

(3)在手机端查看微信，可以查看到报警推送消息，电脑客户端的报警消息会同步推送到手机指定用户。

![Image 1][]

(4)如上图所示，为了避免报警消息打扰到用户，当用户不想接收报警消息时，登录发送报警的用户或者接受报警消息的用户，都可以在手机微信上通过反向控制命令：QStockView:Stop（或者QStockView:停止）停止接收报警消息，也可以通过反向控制命令QStockView:Start（或者QStockView:开始）来开始接收报警消息；不区分大小写，中间不能有空格，否则命令无效。发送命令成功之后，会返回一个通知消息。表示命令发送成功。

# 6       技术制约 #

由于微信的限制，无法自己发给自己，发给文件传输助手、微信群、微信公众号，自己只能显示消息，手机端不会出现屏幕消息提示。所以最好有两个手机账号，一个登陆发送，一个接收消息。因为微信同时只能登录一个网页端或者window的客户端，所以微信登录了之后，不能再去登录网页或者客户端，否则会挤掉登录，导致发送失败。而且微信发送频率不能太快，否则会导致微信发送频繁而被限制发送，需要等待30-60分钟，才可以继续发送。所以可以使用定时器去发送消息，消息发送频率在1次/秒；

# 7       技术应用推广 #

在其他项目现场，如果有需求要推送报警消息到微信，可以复用该方法，去对接微信网页接口，采用微信的方便快捷实现报警推送；

下载地址：

**[https://www.cnblogs.com/bclshuai/p/11380657.html][https_www.cnblogs.com_bclshuai_p_11380657.html]**

**百度云盘下载地址：**

**链接：https://pan.baidu.com/s/1swkQzCIKI3g3ObcebgpIDg**

**提取码：mc8l**

**微信公众号获取最新的软件和视频介绍**

**QStockView**

![1076976-20190627133741773-40800108.png][]

转载于:https://www.cnblogs.com/bclshuai/p/11392644.html

[https_login.wx.qq.com_qrcode_uuid]: https://login.weixin.qq.com/qrcode/%7Buuid%7D
[https_login.wx.qq.com_cgi-bin_mmwebwx-bin_login]: https://login.weixin.qq.com/cgi-bin/mmwebwx-bin/login
[https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxnewloginpage]: https://wx2.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage
[https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxinit]: https://wx2.qq.com/cgi-bin/mmwebwx-bin/webwxinit
[https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxgetcontact]: https://wx2.qq.com/cgi-bin/mmwebwx-bin/webwxgetcontact
[https_webpush2.weixin.qq.com_cgi-bin_mmwebwx-bin_synccheck]: https://webpush2.weixin.qq.com/cgi-bin/mmwebwx-bin/synccheck
[https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxsync]: https://wx2.qq.com/cgi-bin/mmwebwx-bin/webwxsync?sid=xxx&skey=xxx&pass_ticket=xxx
[https_wx.qq.com_cgi-bin_mmwebwx-bin_webwxsendmsg]: https://wx2.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsg?pass_ticket=xxx
[Image 1]: 
[https_www.cnblogs.com_bclshuai_p_11380657.html]: https://www.cnblogs.com/bclshuai/p/11380657.html
[1076976-20190627133741773-40800108.png]: /images/20230601/d5b5180a470449038f7282fc48d571cd.png