From ddb8e8a844f8e595ffb4b202fec575c8ec4d4825 Mon Sep 17 00:00:00 2001
From: urinx <1336006643@qq.com>
Date: Sat, 6 Feb 2016 00:36:48 +0800
Subject: [PATCH] update document & add much more details about APIs
---
README.md | 338 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 337 insertions(+), 1 deletion(-)
diff --git a/README.md b/README.md
index f3a3162..a31bb00 100644
--- a/README.md
+++ b/README.md
@@ -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:
...
}
```
+
+
+### 图片接口
+
+| API | webwxgeticon |
+| --- | ------------ |
+| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgeticon |
+| method | GET |
+| params | **seq**: `数字，可为空`
**username**: `ID`
**skey**: xxx |
+
+| API | webwxgetheadimg |
+| --- | --------------- |
+| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetheadimg |
+| method | GET |
+| params | **seq**: `数字，可为空`
**username**: `群ID`
**skey**: xxx |
+
+| API | webwxgetmsgimg |
+| --- | --------------- |
+| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetmsgimg |
+| method | GET |
+| params | **MsgID**: `消息ID`
**type**: slave `略缩图` or `为空时加载原图`
**skey**: xxx |
+
+
+### 多媒体接口
+
+| API | webwxgetvideo |
+| --- | --------------- |
+| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetvideo |
+| method | GET |
+| params | **msgid**: `消息ID`
**skey**: xxx |
+
+| API | webwxgetvoice |
+| --- | --------------- |
+| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetvoice |
+| method | GET |
+| params | **msgid**: `消息ID`
**skey**: xxx |
+
+
+### 账号类型
+
+| 类型 | 说明 |
+| :--: | --- |
+| 个人账号 | 以`@`开头，例如：`@xxx` |
+| 群聊 | 以`@@`开头，例如：`@@xxx` |
+| 公众号/服务号 | 以`@`开头，但其`VerifyFlag` & 8 != 0
`VerifyFlag`:
一般公众号/服务号：8
微信自家的服务号：24
微信官方账号`微信团队`：56 |
+| 特殊账号 | 像文件传输助手之类的账号，有特殊的ID，目前已知的有：
`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` |
+
+
+### 消息类型
+
+消息一般格式：
+```
+{
+ "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:
+
+
+
+ // 最近联系的联系人
+ filehelper,xxx@chatroom,wxid_xxx,xxx,...
+
+
+
+
+ // 朋友圈
+ MomentsUnreadMsgStatus
+
+
+ 1454502365
+
+
+
+
+ // 未读的功能账号消息，群发助手，漂流瓶等
+
+
+
+```
+
+**文本消息**
+```
+MsgType: 1
+FromUserName: 发送方ID
+ToUserName: 接收方ID
+Content: 消息内容
+```
+
+**图片消息**
+```html
+MsgType: 3
+FromUserName: 发送方ID
+ToUserName: 接收方ID
+MsgId: 用于获取图片
+Content:
+
+ ![]()
+
+
+```
+
+**小视频消息**
+```html
+MsgType: 62
+FromUserName: 发送方ID
+ToUserName: 接收方ID
+MsgId: 用于获取小视频
+Content:
+
+ ![]()
+
+
+```
+
+**地理位置消息**
+```
+MsgType: 1
+FromUserName: 发送方ID
+ToUserName: 接收方ID
+Content: http://weixin.qq.com/cgi-bin/redirectforward?args=xxx
+// 属于文本消息，只不过内容是一个跳转到地图的链接
+```
+
+**名片消息**
+```js
+MsgType: 42
+FromUserName: 发送方ID
+ToUserName: 接收方ID
+Content:
+
+
+
+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:
+
+
+
+```
+
+**动画表情**
+```html
+MsgType: 47
+FromUserName: 发送方ID
+ToUserName: 接收方ID
+Content:
+
+
+
+
+```
+
+**普通链接或应用分享消息**
+```html
+MsgType: 49
+AppMsgType: 5
+FromUserName: 发送方ID
+ToUserName: 接收方ID
+Url: 链接地址
+FileName: 链接标题
+Content:
+
+
+
+
+ 5
+
+
+
+ ...
+
+
+
+
+
+
+```
+
+**音乐链接消息**
+```
+MsgType: 49
+AppMsgType: 3
+FromUserName: 发送方ID
+ToUserName: 接收方ID
+Url: 链接地址
+FileName: 音乐名
+
+AppInfo: // 分享链接的应用
+ {
+ Type: 0,
+ AppID: wx485a97c844086dc9
+ }
+
+Content:
+
+
+
+
+
+ 3
+ 0
+
+
+
+
+ 0
+
+
+
+ http://ws.stream.qqmusic.qq.com/C100003i9hMt1bgui0.m4a?vkey=6867EF99F3684&guid=ffffffffc104ea2964a111cf3ff3edaf&fromtag=46
+
+
+ http://ws.stream.qqmusic.qq.com/C100003i9hMt1bgui0.m4a?vkey=6867EF99F3684&guid=ffffffffc104ea2964a111cf3ff3edaf&fromtag=46
+
+
+ 0
+
+
+
+
+
+
+
+
+
+ http://imgcache.qq.com/music/photo/album/63/180_albumpic_143163_0.jpg
+
+
+
+
+ 0
+
+ 29
+ 摇一摇搜歌
+
+
+
+```
+
+**群消息**
+```
+MsgType: 1
+FromUserName: @@xxx
+ToUserName: @xxx
+Content:
+ @xxx:
xxx
+```
+
+**红包消息**
+```
+MsgType: 49
+AppMsgType: 2001
+FromUserName: 发送方ID
+ToUserName: 接收方ID
+Content:
+ blablabla ...
+```
+
+## 持续更新中 ...