lijiarui
768 lines
22 KiB
Markdown
768 lines
22 KiB
Markdown
# WeixinBot [](http://github.com/Urinx/WeixinBot) [](http://github.com/Urinx/WeixinBot/fork) 
|
||
|
||
网页版微信API，包含终端版微信及微信机器人
|
||
|
||
## Demo
|
||
为了运行 `weixin.py` 示例脚本，你需要有安装 `qrcode` 包，你可以通过 `pip install qrcode` 来安装。
|
||
|
||
|
||
|
||
按照操作指示在手机微信上扫描二维码然后登录，你可以选择是否开启自动回复模式。
|
||
|
||
|
||
|
||
开启自动回复模式后，如果接收到的是文字消息就会自动回复，包括群消息。
|
||
|
||
|
||
|
||
现在，名片，链接，动画表情和地址位置消息都可以正常接收。
|
||
|
||
|
||
|
||
|
||
|
||
**目前支持的命令**：
|
||
|
||
`->[昵称或ID]:[内容]` 给好友发送消息
|
||
|
||
`m->[昵称或ID]:[文件路径]` 给好友发送文件中的内容
|
||
|
||
|
||
|
||
`f->[昵称或ID]:[文件路径]` 给好友发送文件
|
||
|
||
`i->[昵称或ID]:[图片路径]` 给好友发送图片
|
||
|
||
`e->[昵称或ID]:[文件路径]` 给好友发送表情(jpg/gif)
|
||
|
||
`quit` 退出程序
|
||
|
||
|
||
|
||
注意，以上命令均不包含方括号。
|
||
|
||
## Web Weixin Pipeline
|
||
|
||
```
|
||
+--------------+ +---------------+ +---------------+
|
||
| | | | | |
|
||
| Get UUID | | Get Contact | | Status Notify |
|
||
| | | | | |
|
||
+-------+------+ +-------^-------+ +-------^-------+
|
||
| | |
|
||
| +-------+ +--------+
|
||
| | |
|
||
+-------v------+ +-----+--+------+ +--------------+
|
||
| | | | | |
|
||
| Get QRCode | | Weixin Init +------> Sync Check <----+
|
||
| | | | | | |
|
||
+-------+------+ +-------^-------+ +-------+------+ |
|
||
| | | |
|
||
| | +-----------+
|
||
| | |
|
||
+-------v------+ +-------+--------+ +-------v-------+
|
||
| | Confirm Login | | | |
|
||
+------> Login +---------------> New Login Page | | Weixin Sync |
|
||
| | | | | | |
|
||
| +------+-------+ +----------------+ +---------------+
|
||
| |
|
||
|QRCode Scaned|
|
||
+-------------+
|
||
```
|
||
## Discussion Group
|
||
如果你希望和 WeixinBot 的其他开发者交流，或者有什么问题和建议，欢迎大家加入【Youth fed the dog】一起
|
||
|
||
|
||
|
||
注：这个不是群的二维码，是机器人拉你入群，记得回复机器人【Aidog】哦~ （secret code: Aidog）
|
||
|
||
## Web Weixin API
|
||
|
||
### 登录
|
||
|
||
| API | 获取 UUID |
|
||
| --- | --------- |
|
||
| url | https://login.weixin.qq.com/jslogin |
|
||
| method | POST |
|
||
| data | URL Encode |
|
||
| params | **appid**: `应用ID` <br> **fun**: new `应用类型` <br> **lang**: zh\_CN `语言` <br> **_**: `时间戳` |
|
||
|
||
返回数据(String):
|
||
```
|
||
window.QRLogin.code = 200; window.QRLogin.uuid = "xxx"
|
||
```
|
||
> 注：这里的appid就是在微信开放平台注册的应用的AppID。网页版微信有两个AppID，早期的是`wx782c26e4c19acffb`，在微信客户端上显示为应用名称为`Web微信`；现在用的是`wxeb7ec651dd0aefa9`，显示名称为`微信网页版`。
|
||
|
||
|
||
<br>
|
||
|
||
| API | 生成二维码 |
|
||
| --- | --------- |
|
||
| url | https://login.weixin.qq.com/l/ `uuid` |
|
||
<br>
|
||
|
||
| API | 二维码扫描登录 |
|
||
| --- | --------- |
|
||
| url | https://login.weixin.qq.com/cgi-bin/mmwebwx-bin/login |
|
||
| method | GET |
|
||
| params | **tip**: 1 `未扫描` 0 `已扫描` <br> **uuid**: xxx <br> **_**: `时间戳` |
|
||
|
||
返回数据(String):
|
||
```
|
||
window.code=xxx;
|
||
|
||
xxx:
|
||
408 登陆超时
|
||
201 扫描成功
|
||
200 确认登录
|
||
|
||
当返回200时，还会有
|
||
window.redirect_uri="https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage?ticket=xxx&uuid=xxx&lang=xxx&scan=xxx";
|
||
```
|
||
<br>
|
||
|
||
| API | webwxnewloginpage |
|
||
| --- | --------- |
|
||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage |
|
||
| method | GET |
|
||
| params | **ticket**: xxx <br> **uuid**: xxx <br> **lang**: zh_CN `语言` <br> **scan**: xxx <br> **fun**: new |
|
||
|
||
返回数据(XML):
|
||
```
|
||
<error>
|
||
<ret>0</ret>
|
||
<message>OK</message>
|
||
<skey>xxx</skey>
|
||
<wxsid>xxx</wxsid>
|
||
<wxuin>xxx</wxuin>
|
||
<pass_ticket>xxx</pass_ticket>
|
||
<isgrayscale>1</isgrayscale>
|
||
</error>
|
||
```
|
||
<br>
|
||
|
||
### 微信初始化
|
||
|
||
| API | webwxinit |
|
||
| --- | --------- |
|
||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxinit?pass_ticket=xxx&skey=xxx&r=xxx |
|
||
| method | POST |
|
||
| data | JSON |
|
||
| header | ContentType: application/json; charset=UTF-8 |
|
||
| params | { <br> BaseRequest: { <br> Uin: xxx, <br> Sid: xxx, <br> Skey: xxx, <br> DeviceID: xxx, <br> } <br> } |
|
||
|
||
返回数据(JSON):
|
||
```
|
||
{
|
||
"BaseResponse": {
|
||
"Ret": 0,
|
||
"ErrMsg": ""
|
||
},
|
||
"Count": 11,
|
||
"ContactList": [...],
|
||
"SyncKey": {
|
||
"Count": 4,
|
||
"List": [
|
||
{
|
||
"Key": 1,
|
||
"Val": 635705559
|
||
},
|
||
...
|
||
]
|
||
},
|
||
"User": {
|
||
"Uin": xxx,
|
||
"UserName": xxx,
|
||
"NickName": xxx,
|
||
"HeadImgUrl": xxx,
|
||
"RemarkName": "",
|
||
"PYInitial": "",
|
||
"PYQuanPin": "",
|
||
"RemarkPYInitial": "",
|
||
"RemarkPYQuanPin": "",
|
||
"HideInputBarFlag": 0,
|
||
"StarFriend": 0,
|
||
"Sex": 1,
|
||
"Signature": "Apt-get install B",
|
||
"AppAccountFlag": 0,
|
||
"VerifyFlag": 0,
|
||
"ContactFlag": 0,
|
||
"WebWxPluginSwitch": 0,
|
||
"HeadImgFlag": 1,
|
||
"SnsFlag": 17
|
||
},
|
||
"ChatSet": xxx,
|
||
"SKey": xxx,
|
||
"ClientVersion": 369297683,
|
||
"SystemTime": 1453124908,
|
||
"GrayScale": 1,
|
||
"InviteStartCount": 40,
|
||
"MPSubscribeMsgCount": 2,
|
||
"MPSubscribeMsgList": [...],
|
||
"ClickReportInterval": 600000
|
||
}
|
||
```
|
||
<br>
|
||
|
||
| API | webwxstatusnotify |
|
||
| --- | --------- |
|
||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxstatusnotify?lang=zh_CN&pass_ticket=xxx |
|
||
| method | POST |
|
||
| data | JSON |
|
||
| header | ContentType: application/json; charset=UTF-8 |
|
||
| params | { <br> BaseRequest: { Uin: xxx, Sid: xxx, Skey: xxx, DeviceID: xxx }, <br> Code: 3, <br> FromUserName: `自己ID`, <br> ToUserName: `自己ID`, <br> ClientMsgId: `时间戳` <br> } |
|
||
|
||
返回数据(JSON):
|
||
```
|
||
{
|
||
"BaseResponse": {
|
||
"Ret": 0,
|
||
"ErrMsg": ""
|
||
},
|
||
...
|
||
}
|
||
```
|
||
<br>
|
||
|
||
### 获取联系人信息
|
||
|
||
| API | webwxgetcontact |
|
||
| --- | --------- |
|
||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin//webwxgetcontact?pass_ticket=xxx&skey=xxx&r=xxx |
|
||
| method | POST |
|
||
| data | JSON |
|
||
| header | ContentType: application/json; charset=UTF-8 |
|
||
|
||
返回数据(JSON):
|
||
```
|
||
{
|
||
"BaseResponse": {
|
||
"Ret": 0,
|
||
"ErrMsg": ""
|
||
},
|
||
"MemberCount": 334,
|
||
"MemberList": [
|
||
{
|
||
"Uin": 0,
|
||
"UserName": xxx,
|
||
"NickName": "Urinx",
|
||
"HeadImgUrl": xxx,
|
||
"ContactFlag": 3,
|
||
"MemberCount": 0,
|
||
"MemberList": [],
|
||
"RemarkName": "",
|
||
"HideInputBarFlag": 0,
|
||
"Sex": 0,
|
||
"Signature": "你好，我们是地球三体组织。在这里，你将感受到不一样的思维模式，以及颠覆常规的世界观。而我们的目标，就是以三体人的智慧，引领人类未来科学技术500年。",
|
||
"VerifyFlag": 8,
|
||
"OwnerUin": 0,
|
||
"PYInitial": "URINX",
|
||
"PYQuanPin": "Urinx",
|
||
"RemarkPYInitial": "",
|
||
"RemarkPYQuanPin": "",
|
||
"StarFriend": 0,
|
||
"AppAccountFlag": 0,
|
||
"Statues": 0,
|
||
"AttrStatus": 0,
|
||
"Province": "",
|
||
"City": "",
|
||
"Alias": "Urinxs",
|
||
"SnsFlag": 0,
|
||
"UniFriend": 0,
|
||
"DisplayName": "",
|
||
"ChatRoomId": 0,
|
||
"KeyWord": "gh_",
|
||
"EncryChatRoomId": ""
|
||
},
|
||
...
|
||
],
|
||
"Seq": 0
|
||
}
|
||
```
|
||
<br>
|
||
|
||
| API | webwxbatchgetcontact |
|
||
| --- | --------- |
|
||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxbatchgetcontact?type=ex&r=xxx&pass_ticket=xxx |
|
||
| method | POST |
|
||
| data | JSON |
|
||
| header | ContentType: application/json; charset=UTF-8 |
|
||
| params | { <br> BaseRequest: { Uin: xxx, Sid: xxx, Skey: xxx, DeviceID: xxx }, <br> Count: `群数量`, <br> List: [ <br> { UserName: `群ID`, EncryChatRoomId: "" }, <br> ... <br> ], <br> } |
|
||
|
||
返回数据(JSON)同上
|
||
<br><br>
|
||
|
||
### 同步刷新
|
||
|
||
| API | synccheck |
|
||
| --- | --------- |
|
||
| protocol | https |
|
||
| host | webpush.weixin.qq.com <br> webpush2.weixin.qq.com <br> webpush.wechat.com <br> webpush1.wechat.com <br> webpush2.wechat.com <br> webpush.wechatapp.com <br> webpush1.wechatapp.com |
|
||
| path | /cgi-bin/mmwebwx-bin/synccheck |
|
||
| method | GET |
|
||
| data | URL Encode |
|
||
| params | **r**: `时间戳` <br> **sid**: xxx <br> **uin**: xxx <br> **skey**: xxx <br> **deviceid**: xxx <br> **synckey**: xxx <br> **_**: `时间戳` |
|
||
|
||
返回数据(String):
|
||
```
|
||
window.synccheck={retcode:"xxx",selector:"xxx"}
|
||
|
||
retcode:
|
||
0 正常
|
||
1100 失败/登出微信
|
||
selector:
|
||
0 正常
|
||
2 新的消息
|
||
7 进入/离开聊天界面
|
||
```
|
||
<br>
|
||
|
||
| API | webwxsync |
|
||
| --- | --------- |
|
||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsync?sid=xxx&skey=xxx&pass_ticket=xxx |
|
||
| method | POST |
|
||
| data | JSON |
|
||
| header | ContentType: application/json; charset=UTF-8 |
|
||
| params | { <br> BaseRequest: { Uin: xxx, Sid: xxx, Skey: xxx, DeviceID: xxx }, <br> SyncKey: xxx, <br> rr: `时间戳取反` <br> } |
|
||
|
||
返回数据(JSON):
|
||
```
|
||
{
|
||
'BaseResponse': {'ErrMsg': '', 'Ret': 0},
|
||
'SyncKey': {
|
||
'Count': 7,
|
||
'List': [
|
||
{'Val': 636214192, 'Key': 1},
|
||
...
|
||
]
|
||
},
|
||
'ContinueFlag': 0,
|
||
'AddMsgCount': 1,
|
||
'AddMsgList': [
|
||
{
|
||
'FromUserName': '',
|
||
'PlayLength': 0,
|
||
'RecommendInfo': {...},
|
||
'Content': "",
|
||
'StatusNotifyUserName': '',
|
||
'StatusNotifyCode': 5,
|
||
'Status': 3,
|
||
'VoiceLength': 0,
|
||
'ToUserName': '',
|
||
'ForwardFlag': 0,
|
||
'AppMsgType': 0,
|
||
'AppInfo': {'Type': 0, 'AppID': ''},
|
||
'Url': '',
|
||
'ImgStatus': 1,
|
||
'MsgType': 51,
|
||
'ImgHeight': 0,
|
||
'MediaId': '',
|
||
'FileName': '',
|
||
'FileSize': '',
|
||
...
|
||
},
|
||
...
|
||
],
|
||
'ModChatRoomMemberCount': 0,
|
||
'ModContactList': [],
|
||
'DelContactList': [],
|
||
'ModChatRoomMemberList': [],
|
||
'DelContactCount': 0,
|
||
...
|
||
}
|
||
```
|
||
<br>
|
||
|
||
### 消息接口
|
||
|
||
| API | webwxsendmsg |
|
||
| --- | ------------ |
|
||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsg?pass_ticket=xxx |
|
||
| method | POST |
|
||
| data | JSON |
|
||
| header | ContentType: application/json; charset=UTF-8 |
|
||
| params | { <br> BaseRequest: { Uin: xxx, Sid: xxx, Skey: xxx, DeviceID: xxx }, <br> Msg: { <br> Type: 1 `文字消息`, <br> Content: `要发送的消息`, <br> FromUserName: `自己ID`, <br> ToUserName: `好友ID`, <br> LocalID: `与clientMsgId相同`, <br> ClientMsgId: `时间戳左移4位随后补上4位随机数` <br> } <br> } |
|
||
|
||
返回数据(JSON):
|
||
```
|
||
{
|
||
"BaseResponse": {
|
||
"Ret": 0,
|
||
"ErrMsg": ""
|
||
},
|
||
...
|
||
}
|
||
```
|
||
|
||
#### 发送表情
|
||
|
||
| API | webwxsendmsgemotion |
|
||
| --- | ------------ |
|
||
| url | https://wx2.qq.com/cgi-bin/mmwebwx-bin/webwxsendemoticon?fun=sys&f=json&pass_ticket=xxx |
|
||
| method | POST |
|
||
| data | JSON |
|
||
| header | ContentType: application/json; charset=UTF-8 |
|
||
| params | { <br> BaseRequest: { Uin: xxx, Sid: xxx, Skey: xxx, DeviceID: xxx }, <br> Msg: { <br> Type: 47 `emoji消息`, <br> EmojiFlag: 2, <br> MediaId: `表情上传后的媒体ID`, <br> FromUserName: `自己ID`, <br> ToUserName: `好友ID`, <br> LocalID: `与clientMsgId相同`, <br> ClientMsgId: `时间戳左移4位随后补上4位随机数` <br> } <br> } |
|
||
|
||
<br>
|
||
|
||
### 图片接口
|
||
|
||
| API | webwxgeticon |
|
||
| --- | ------------ |
|
||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgeticon |
|
||
| method | GET |
|
||
| params | **seq**: `数字，可为空` <br> **username**: `ID` <br> **skey**: xxx |
|
||
<br>
|
||
|
||
| API | webwxgetheadimg |
|
||
| --- | --------------- |
|
||
| url | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetheadimg |
|
||
| method | GET |
|
||
| params | **seq**: `数字，可为空` <br> **username**: `群ID` <br> **skey**: xxx |
|
||
<br>
|
||
|
||
| 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 |
|
||
<br>
|
||
|
||
| 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
|
||
}
|
||
```
|
||
<br>
|
||
|
||
| 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 | 系统消息 |
|
||
| 10002 | 撤回消息 |
|
||
<br>
|
||
|
||
**微信初始化消息**
|
||
```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>
|
||
```
|
||
|
||
**音乐链接消息**
|
||
```html
|
||
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: 未知
|
||
```
|
||
注：根据网页版的代码可以看到未来可能支持查看红包消息，但目前走的是系统消息，见下。
|
||
|
||
**系统消息**
|
||
```
|
||
MsgType: 10000
|
||
FromUserName: 发送方ID
|
||
ToUserName: 自己ID
|
||
Content:
|
||
"你已添加了 xxx ，现在可以开始聊天了。"
|
||
"如果陌生人主动添加你为朋友，请谨慎核实对方身份。"
|
||
"收到红包，请在手机上查看"
|
||
```
|
||
|
||
持续更新中 ...
|
||
|
||
## Todo
|
||
- [x] 发送图片或者文件功能
|
||
- [ ] 主动给群聊发送消息
|
||
- [ ] 建立群聊
|
||
- [x] 群发消息
|
||
- [ ] 补充更多的接口及完善文档
|
||
|
||
P.S. 还有啥要补充的也可以在[issue #8](https://github.com/Urinx/WeixinBot/issues/8)下留言
|