update document & add much more details about APIs
This commit is contained in:
urinx
@@ -363,7 +363,7 @@ selector:
|
||||
### 消息接口
|
||||
|
||||
| API | webwxsendmsg |
|
||||
| --- | --------- |
|
||||
| --- | ------------ |
|
||||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsg?pass_ticket=xxx |
|
||||
| method | POST |
|
||||
| data | JSON |
|
||||
@@ -380,3 +380,339 @@ selector:
|
||||
...
|
||||
}
|
||||
```
|
||||
<br>
|
||||
|
||||
### 图片接口
|
||||
|
||||
| API | webwxgeticon |
|
||||
| --- | ------------ |
|
||||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgeticon |
|
||||
| method | GET |
|
||||
| params | **seq**: `数字，可为空` <br> **username**: `ID` <br> **skey**: xxx |
|
||||
|
||||
| API | webwxgetheadimg |
|
||||
| --- | --------------- |
|
||||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetheadimg |
|
||||
| method | GET |
|
||||
| params | **seq**: `数字，可为空` <br> **username**: `群ID` <br> **skey**: xxx |
|
||||
|
||||
| API | webwxgetmsgimg |
|
||||
| --- | --------------- |
|
||||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetmsgimg |
|
||||
| method | GET |
|
||||
| params | **MsgID**: `消息ID` <br> **type**: slave `略缩图` or `为空时加载原图` <br> **skey**: xxx |
|
||||
<br>
|
||||
|
||||
### 多媒体接口
|
||||
|
||||
| API | webwxgetvideo |
|
||||
| --- | --------------- |
|
||||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetvideo |
|
||||
| method | GET |
|
||||
| params | **msgid**: `消息ID` <br> **skey**: xxx |
|
||||
|
||||
| API | webwxgetvoice |
|
||||
| --- | --------------- |
|
||||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetvoice |
|
||||
| method | GET |
|
||||
| params | **msgid**: `消息ID` <br> **skey**: xxx |
|
||||
<br>
|
||||
|
||||
### 账号类型
|
||||
|
||||
| 类型 | 说明 |
|
||||
| :--: | --- |
|
||||
| 个人账号 | 以`@`开头，例如：`@xxx` |
|
||||
| 群聊 | 以`@@`开头，例如：`@@xxx` |
|
||||
| 公众号/服务号 | 以`@`开头，但其`VerifyFlag` & 8 != 0 <br><br> `VerifyFlag`: <br> 一般公众号/服务号：8 <br> 微信自家的服务号：24 <br> 微信官方账号`微信团队`：56 |
|
||||
| 特殊账号 | 像文件传输助手之类的账号，有特殊的ID，目前已知的有：<br> `filehelper`, `newsapp`, `fmessage`, `weibo`, `qqmail`, `fmessage`, `tmessage`, `qmessage`, `qqsync`, `floatbottle`, `lbsapp`, `shakeapp`, `medianote`, `qqfriend`, `readerapp`, `blogapp`, `facebookapp`, `masssendapp`, `meishiapp`, `feedsapp`, `voip`, `blogappweixin`, `weixin`, `brandsessionholder`, `weixinreminder`, `officialaccounts`, `notification_messages`, `wxitil`, `userexperience_alarm`, `notification_messages` |
|
||||
<br>
|
||||
|
||||
### 消息类型
|
||||
|
||||
消息一般格式：
|
||||
```
|
||||
{
|
||||
"FromUserName": "",
|
||||
"ToUserName": "",
|
||||
"Content": "",
|
||||
"StatusNotifyUserName": "",
|
||||
"ImgWidth": 0,
|
||||
"PlayLength": 0,
|
||||
"RecommendInfo": {...},
|
||||
"StatusNotifyCode": 4,
|
||||
"NewMsgId": "",
|
||||
"Status": 3,
|
||||
"VoiceLength": 0,
|
||||
"ForwardFlag": 0,
|
||||
"AppMsgType": 0,
|
||||
"Ticket": "",
|
||||
"AppInfo": {...},
|
||||
"Url": "",
|
||||
"ImgStatus": 1,
|
||||
"MsgType": 1,
|
||||
"ImgHeight": 0,
|
||||
"MediaId": "",
|
||||
"MsgId": "",
|
||||
"FileName": "",
|
||||
"HasProductId": 0,
|
||||
"FileSize": "",
|
||||
"CreateTime": 1454602196,
|
||||
"SubMsgType": 0
|
||||
}
|
||||
```
|
||||
|
||||
| MsgType | 说明 |
|
||||
| ------- | --- |
|
||||
| 1 | 文本消息 |
|
||||
| 3 | 图片消息 |
|
||||
| 34 | 语音消息 |
|
||||
| 37 | VERIFYMSG |
|
||||
| 40 | POSSIBLEFRIEND_MSG |
|
||||
| 42 | 共享名片 |
|
||||
| 43 | 视频通话消息 |
|
||||
| 47 | 动画表情 |
|
||||
| 48 | 位置消息 |
|
||||
| 49 | 分享链接 |
|
||||
| 50 | VOIPMSG |
|
||||
| 51 | 微信初始化消息 |
|
||||
| 52 | VOIPNOTIFY |
|
||||
| 53 | VOIPINVITE |
|
||||
| 62 | 小视频 |
|
||||
| 9999 | SYSNOTICE |
|
||||
| 10000 | SYS |
|
||||
| 10002 | 撤回消息 |
|
||||
|
||||
**微信初始化消息**
|
||||
```html
|
||||
MsgType: 51
|
||||
FromUserName: 自己ID
|
||||
ToUserName: 自己ID
|
||||
StatusNotifyUserName: 最近联系的联系人ID
|
||||
Content:
|
||||
<msg>
|
||||
<op id='4'>
|
||||
<username>
|
||||
// 最近联系的联系人
|
||||
filehelper,xxx@chatroom,wxid_xxx,xxx,...
|
||||
</username>
|
||||
<unreadchatlist>
|
||||
<chat>
|
||||
<username>
|
||||
// 朋友圈
|
||||
MomentsUnreadMsgStatus
|
||||
</username>
|
||||
<lastreadtime>
|
||||
1454502365
|
||||
</lastreadtime>
|
||||
</chat>
|
||||
</unreadchatlist>
|
||||
<unreadfunctionlist>
|
||||
// 未读的功能账号消息，群发助手，漂流瓶等
|
||||
</unreadfunctionlist>
|
||||
</op>
|
||||
</msg>
|
||||
```
|
||||
|
||||
**文本消息**
|
||||
```
|
||||
MsgType: 1
|
||||
FromUserName: 发送方ID
|
||||
ToUserName: 接收方ID
|
||||
Content: 消息内容
|
||||
```
|
||||
|
||||
**图片消息**
|
||||
```html
|
||||
MsgType: 3
|
||||
FromUserName: 发送方ID
|
||||
ToUserName: 接收方ID
|
||||
MsgId: 用于获取图片
|
||||
Content:
|
||||
<msg>
|
||||
<img length="6503" hdlength="0" />
|
||||
<commenturl></commenturl>
|
||||
</msg>
|
||||
```
|
||||
|
||||
**小视频消息**
|
||||
```html
|
||||
MsgType: 62
|
||||
FromUserName: 发送方ID
|
||||
ToUserName: 接收方ID
|
||||
MsgId: 用于获取小视频
|
||||
Content:
|
||||
<msg>
|
||||
<img length="6503" hdlength="0" />
|
||||
<commenturl></commenturl>
|
||||
</msg>
|
||||
```
|
||||
|
||||
**地理位置消息**
|
||||
```
|
||||
MsgType: 1
|
||||
FromUserName: 发送方ID
|
||||
ToUserName: 接收方ID
|
||||
Content: http://weixin.qq.com/cgi-bin/redirectforward?args=xxx
|
||||
// 属于文本消息，只不过内容是一个跳转到地图的链接
|
||||
```
|
||||
|
||||
**名片消息**
|
||||
```js
|
||||
MsgType: 42
|
||||
FromUserName: 发送方ID
|
||||
ToUserName: 接收方ID
|
||||
Content:
|
||||
<?xml version="1.0"?>
|
||||
<msg bigheadimgurl="" smallheadimgurl="" username="" nickname="" shortpy="" alias="" imagestatus="3" scene="17" province="" city="" sign="" sex="1" certflag="0" certinfo="" brandIconUrl="" brandHomeUrl="" brandSubscriptConfigUrl="" brandFlags="0" regionCode="" />
|
||||
|
||||
RecommendInfo:
|
||||
{
|
||||
"UserName": "xxx", // ID
|
||||
"Province": "xxx",
|
||||
"City": "xxx",
|
||||
"Scene": 17,
|
||||
"QQNum": 0,
|
||||
"Content": "",
|
||||
"Alias": "xxx", // 微信号
|
||||
"OpCode": 0,
|
||||
"Signature": "",
|
||||
"Ticket": "",
|
||||
"Sex": 0, // 1:男, 2:女
|
||||
"NickName": "xxx", // 昵称
|
||||
"AttrStatus": 4293221,
|
||||
"VerifyFlag": 0
|
||||
}
|
||||
```
|
||||
|
||||
**语音消息**
|
||||
```html
|
||||
MsgType: 34
|
||||
FromUserName: 发送方ID
|
||||
ToUserName: 接收方ID
|
||||
MsgId: 用于获取语音
|
||||
Content:
|
||||
<msg>
|
||||
<voicemsg endflag="1" cancelflag="0" forwardflag="0" voiceformat="4" voicelength="1580" length="2026" bufid="216825389722501519" clientmsgid="49efec63a9774a65a932a4e5fcd4e923filehelper174_1454602489" fromusername="" />
|
||||
</msg>
|
||||
```
|
||||
|
||||
**动画表情**
|
||||
```html
|
||||
MsgType: 47
|
||||
FromUserName: 发送方ID
|
||||
ToUserName: 接收方ID
|
||||
Content:
|
||||
<msg>
|
||||
<emoji fromusername = "" tousername = "" type="2" idbuffer="media:0_0" md5="e68363487d8f0519c4e1047de403b2e7" len = "86235" productid="com.tencent.xin.emoticon.bilibili" androidmd5="e68363487d8f0519c4e1047de403b2e7" androidlen="86235" s60v3md5 = "e68363487d8f0519c4e1047de403b2e7" s60v3len="86235" s60v5md5 = "e68363487d8f0519c4e1047de403b2e7" s60v5len="86235" cdnurl = "http://emoji.qpic.cn/wx_emoji/eFygWtxcoMF8M0oCCsksMA0gplXAFQNpiaqsmOicbXl1OC4Tyx18SGsQ/" designerid = "" thumburl = "http://mmbiz.qpic.cn/mmemoticon/dx4Y70y9XctRJf6tKsy7FwWosxd4DAtItSfhKS0Czr56A70p8U5O8g/0" encrypturl = "http://emoji.qpic.cn/wx_emoji/UyYVK8GMlq5VnJ56a4GkKHAiaC266Y0me0KtW6JN2FAZcXiaFKccRevA/" aeskey= "a911cc2ec96ddb781b5ca85d24143642" ></emoji>
|
||||
<gameext type="0" content="0" ></gameext>
|
||||
</msg>
|
||||
```
|
||||
|
||||
**普通链接或应用分享消息**
|
||||
```html
|
||||
MsgType: 49
|
||||
AppMsgType: 5
|
||||
FromUserName: 发送方ID
|
||||
ToUserName: 接收方ID
|
||||
Url: 链接地址
|
||||
FileName: 链接标题
|
||||
Content:
|
||||
<msg>
|
||||
<appmsg appid="" sdkver="0">
|
||||
<title></title>
|
||||
<des></des>
|
||||
<type>5</type>
|
||||
<content></content>
|
||||
<url></url>
|
||||
<thumburl></thumburl>
|
||||
...
|
||||
</appmsg>
|
||||
<appinfo>
|
||||
<version></version>
|
||||
<appname></appname>
|
||||
</appinfo>
|
||||
</msg>
|
||||
```
|
||||
|
||||
**音乐链接消息**
|
||||
```
|
||||
MsgType: 49
|
||||
AppMsgType: 3
|
||||
FromUserName: 发送方ID
|
||||
ToUserName: 接收方ID
|
||||
Url: 链接地址
|
||||
FileName: 音乐名
|
||||
|
||||
AppInfo: // 分享链接的应用
|
||||
{
|
||||
Type: 0,
|
||||
AppID: wx485a97c844086dc9
|
||||
}
|
||||
|
||||
Content:
|
||||
<msg>
|
||||
<appmsg appid="wx485a97c844086dc9" sdkver="0">
|
||||
<title></title>
|
||||
<des></des>
|
||||
<action></action>
|
||||
<type>3</type>
|
||||
<showtype>0</showtype>
|
||||
<mediatagname></mediatagname>
|
||||
<messageext></messageext>
|
||||
<messageaction></messageaction>
|
||||
<content></content>
|
||||
<contentattr>0</contentattr>
|
||||
<url></url>
|
||||
<lowurl></lowurl>
|
||||
<dataurl>
|
||||
http://ws.stream.qqmusic.qq.com/C100003i9hMt1bgui0.m4a?vkey=6867EF99F3684&guid=ffffffffc104ea2964a111cf3ff3edaf&fromtag=46
|
||||
</dataurl>
|
||||
<lowdataurl>
|
||||
http://ws.stream.qqmusic.qq.com/C100003i9hMt1bgui0.m4a?vkey=6867EF99F3684&guid=ffffffffc104ea2964a111cf3ff3edaf&fromtag=46
|
||||
</lowdataurl>
|
||||
<appattach>
|
||||
<totallen>0</totallen>
|
||||
<attachid></attachid>
|
||||
<emoticonmd5></emoticonmd5>
|
||||
<fileext></fileext>
|
||||
</appattach>
|
||||
<extinfo></extinfo>
|
||||
<sourceusername></sourceusername>
|
||||
<sourcedisplayname></sourcedisplayname>
|
||||
<commenturl></commenturl>
|
||||
<thumburl>
|
||||
http://imgcache.qq.com/music/photo/album/63/180_albumpic_143163_0.jpg
|
||||
</thumburl>
|
||||
<md5></md5>
|
||||
</appmsg>
|
||||
<fromusername></fromusername>
|
||||
<scene>0</scene>
|
||||
<appinfo>
|
||||
<version>29</version>
|
||||
<appname>摇一摇搜歌</appname>
|
||||
</appinfo>
|
||||
<commenturl></commenturl>
|
||||
</msg>
|
||||
```
|
||||
|
||||
**群消息**
|
||||
```
|
||||
MsgType: 1
|
||||
FromUserName: @@xxx
|
||||
ToUserName: @xxx
|
||||
Content:
|
||||
@xxx:<br/>xxx
|
||||
```
|
||||
|
||||
**红包消息**
|
||||
```
|
||||
MsgType: 49
|
||||
AppMsgType: 2001
|
||||
FromUserName: 发送方ID
|
||||
ToUserName: 接收方ID
|
||||
Content:
|
||||
blablabla ...
|
||||
```
|
||||
|
||||
## 持续更新中 ...
|
||||
|
||||
Reference in New Issue
Block a user