Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lbbniu/webwechat
网页微信PHP登录的实现
https://github.com/lbbniu/webwechat
Last synced: 6 days ago
JSON representation
网页微信PHP登录的实现
- Host: GitHub
- URL: https://github.com/lbbniu/webwechat
- Owner: lbbniu
- Created: 2016-10-16T18:08:32.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2022-08-19T07:01:14.000Z (about 2 years ago)
- Last Synced: 2024-10-29T11:11:46.935Z (7 days ago)
- Language: PHP
- Size: 243 KB
- Stars: 477
- Watchers: 29
- Forks: 119
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# WebWechat
网页微信PHP登录的实现
依赖扩展
---
* curl
* pcntl 或者 pthreads
* gd
# 微信网页版协议分析
## 微信网页版协议分析（1）-登录
最近研究了微信网页版的实现原理，接下来会通过一系列的文章来总结这次研究的结果，最终会通过PHP代码实现一个简单的微信机器人程序。
### 1.获取uuid（get）
https://login.wx.qq.com/jslogin?appid=wx782c26e4c19acffb&redirect_uri=https%3A%2F%2Fwx.qq.com%2Fcgi-bin%2Fmmwebwx-bin%2Fwebwxnewloginpage&fun=new&lang=zh_CN&_=1476606163580
#### 参数：
```
appid：固定为wx782c26e4c19acffb
redirect_rui：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage经过url编码
fun：固定值new
lang：语言类型，中国zh_CN
_：当前的unix时间戳
```
#### 返回数据格式：
```
window.QRLogin.code = 200; window.QRLogin.uuid = "gf5Gk61zEA==";
window.QRLogin.uuid的值就是我们需要的uuid
```
### 2.获取二维码（get）
```
https://login.weixin.qq.com/qrcode/gf5Gk61zEA==
固定格式：https://login.weixin.qq.com/qrcode/ 拼接上第一步的带的uuid
```
#### 二维码中实际内容如下地址：
```
https://login.weixin.qq.com/l/gf5Gk61zEA==
即：https://login.weixin.qq.com/l/ 加上那个uuid
```
### 3.等待登录扫描（get轮询）：
https://login.wx.qq.com/cgi-bin/mmwebwx-bin/login?loginicon=true&uuid=gf5Gk61zEA==&tip=0&r=862560455&_=1476606163582
#### 参数：
```
loginicon：true
uuid：第一步得到的uuid
tip：0
r：862560455 非必须参数
_：同上为unix时间戳
```
#### 返回数据格式：
```
window.code=408;//登录超时code为408
window.code=201;window.userAvatar = 'data:img/jpg;base64';//扫描成功 201，userAvatar为用户头像
window.code=200;//确认登录code 200， 还有下面的redirect_uri的获取cookie的连接
window.redirect_uri="https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage?ticket=AYfheMIH6tt9EmcZ0DxCKF4a@qrticket_0&uuid=YeGrrvqmHQ==&lang=zh_CN&scan=1476606728";
```
### 4.登录后获取cookie信息（get）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage?ticket=AYfheMIH6tt9EmcZ0DxCKF4a@qrticket_0&uuid=YeGrrvqmHQ==&lang=zh_CN&scan=1476606728&fun=new&version=v2&lang=zh_CN
此连接是上一步确认登录后获取的连接。
#### 返回数据格式（xml，还有登录后设置的cookie数据）：
```xml
0
@crypt_14ae1b12_b73ba2673448154847d7007a2de3c53b
jSsRlGGPyY7U8det
566148615
kUY4PSgKNy4eOlWI%2FwIBMVULe3KHPVyvDqw1%2B4DVVu9McVvE2d5fL7LFOfa4iYnk
1
xml中skey、wxsid、wxuin、pass_ticket重要参数，
要在接来的请求中使用，需要记下来，还有返回的cookie信息，在接下来的请求中，都要去携带上才可以。
```
## 微信网页版协议分析（2）-获取信息
### 1.微信初始化请求（post）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxinit?r=862039733&lang=zh_CN&pass_ticket=kUY4PSgKNy4eOlWI%252FwIBMVULe3KHPVyvDqw1%252B4DVVu9McVvE2d5fL7LFOfa4iYnk
这个请求会获取联系人信息、公众号信息、自己的账号信息
#### 请求头：
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"BaseRequest": {
"Uin": "566148615",
"Sid": "jSsRlGGPyY7U8det",
"Skey": "@crypt_14ae1b12_b73ba2673448154847d7007a2de3c53b",
"DeviceID": "e119795675188164"
}
}
Uin、Sid、Skey 登录后获取的xml中的数据
DeviceID 是e + 随机数
```
#### 返回数据（json，用户的好友信息）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"Count": 11,
"ContactList": [...], //联系人信息、公众号信息、群
"SyncKey": {
"Count": 4,
"List": [
{
"Key": 1,
"Val": 635705559
},
... //同步key值，下次请求时要写到上
]
},
"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": "@crypt_14ae1b12_b73ba2673448154847d7007a2de3c53b",
"ClientVersion": 369302288,
"SystemTime": 1476608977,
"GrayScale": 1,
"InviteStartCount": 40,
"MPSubscribeMsgCount": 7,
"ClickReportInterval": 600000
}
```
### 2.webwxstatusnotify通知消息已读（post）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxstatusnotify?pass_ticket=ZDJfLCa0EAKrLn2CdD7MDl%252B54GwlW0IEiwYOsm6II%252F8W57y0pF1F8fqS%252B5z4INU5
客户端读取消息后要发起请求，告诉服务器消息已经读取，从而通知手机客户端
#### 参数
```
pass_ticket 登录请求返回的xml中的值
```
#### 请求头：
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"BaseRequest": {
"Uin": 566148615,
"Sid": "EKjoZCMRIvrY7NIP",
"Skey": "@crypt_14ae1b12_f59314a579c67b15f838d09feb79c17f",
"DeviceID": "e098855372553243"
},
"Code": 3,
"FromUserName": 自己ID,
"ToUserName": 自己ID,
"ClientMsgId": 时间戳
}
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"MsgID": "1525762281689643050"
}
```
### 3.获取联系人信息列表（get）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetcontact?pass_ticket=ZDJfLCa0EAKrLn2CdD7MDl%252B54GwlW0IEiwYOsm6II%252F8W57y0pF1F8fqS%252B5z4INU5&r=1476608979549&seq=0&skey=@crypt_14ae1b12_f59314a579c67b15f838d09feb79c17f
#### 参数
```
pass_ticket 登录请求中返回xml中获取
seq=0 固定值即可
skey 初始化请求中获取
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"MemberCount": 637,
"MemberList": [
{
"Uin": 0,
"UserName": xxx,
"NickName": "LbbNiu",
"HeadImgUrl": xxx,
"ContactFlag": 3,
"MemberCount": 0,
"MemberList": [],
"RemarkName": "",
"HideInputBarFlag": 0,
"Sex": 0,
"Signature": "IT全才-LbbNiu",
"VerifyFlag": 8,
"OwnerUin": 0,
"PYInitial": "LbbNiu",
"PYQuanPin": "LbbNiu",
"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
}
```
### 4.webwxbatchgetcontact获取聊天会话列表信息（post）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxbatchgetcontact?type=ex&r=1476608979648&pass_ticket=ZDJfLCa0EAKrLn2CdD7MDl%252B54GwlW0IEiwYOsm6II%252F8W57y0pF1F8fqS%252B5z4INU5
#### 参数
```
type=ex 固定值即可
r 当前时间戳
pass_ticket 登录请求中返回xml中获取
```
#### 请求头：
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"BaseRequest": {
"Uin": 566148615,
"Sid": "EKjoZCMRIvrY7NIP",
"Skey": "@crypt_14ae1b12_f59314a579c67b15f838d09feb79c17f",
"DeviceID": "e316575061818116"
},
"Count": 7,
"List": [
{
"UserName": "@@e2da072e5beda58413f788fd2978b6f9fbde2ba337a71f02e1458958fcdb8371", //去要获取的群UserName
"ChatRoomId": ""
}…
]
}
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"Count": 7,
"ContactList": [
]
}
```
### 5.同步刷新（get轮询）：
https://webpush.wx.qq.com/cgi-bin/mmwebwx-bin/synccheck?r=1476611147442&skey=%40crypt_14ae1b12_f59314a579c67b15f838d09feb79c17f&sid=EKjoZCMRIvrY7NIP&uin=566148615&deviceid=e673682280871456&synckey=1_643606091%7C2_643606203%7C3_643606171%7C11_643605834%7C13_643590001%7C201_1476611120%7C1000_1476610779%7C1001_1476590971%7C1004_1475896795&_=1476611120940
#### 参数
```
r 时间戳
skey 初始化信息中获取
sid 登录请求中返回xml中获取
uin 登录请求中返回xml中获取
synckey 初始化信息中获取
deviceid 设备id
_ 时间戳
```
#### 返回数据：
```
window.synccheck={retcode:"0",selector:"2"}
retcode:
0 正常
1100 失败/登出微信
selector:
0 正常
2 新的消息
4 通过时发现，删除好友
6 删除时发现和对方通过好友验证
7 进入/离开聊天界面 （可能没有了）
```
### 6.获取消息（post，cookie）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsync?sid=2qui+CC4YTiiI2zk&skey=@crypt_14ae1b12_1bb5e370393b8cd502919825fe9dbfc0&lang=zh_CN&pass_ticket=tM909DkHH8fXLR7hhwIgn9MqmSuCxx6%252BcdaA9qE203zxP7fMT%252FtxPlY7opbnnVE2
#### 参数
```
pass_ticket 登录请求中返回xml中获取
r 时间戳
skey 初始化信息中获取
sid 登录请求中返回xml中获取
lang=zh_CN 语言类型
```
#### 请求头：
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"BaseRequest":{
"Uin":566148615,
"Sid":"2qui+CC4YTiiI2zk",
"Skey":"@crypt_14ae1b12_1bb5e370393b8cd502919825fe9dbfc0",
"DeviceID":"e151332185497293"
},
"SyncKey":{
"Count":9,
"List":[
{"Key":1,"Val":643606091},
{"Key":2,"Val":643606236},
{"Key":3,"Val":643606171},
{"Key":11,"Val":643606232},
{"Key":13,"Val":643590001},
{"Key":203,"Val":1476612126},
{"Key":1000,"Val":1476610779},
{"Key":1001,"Val":1476590971},
{"Key":1004,"Val":1475896795}
]
},
"rr":856481324
}
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"AddMsgCount": 1,
"AddMsgList": [
{
"MsgId": "8410419333108271670",
"FromUserName": "@595d9f44c64e2f480baa0d6430ca58ef053a768daa6d7b3fcc4bece244bcbce3",
"ToUserName": "@e5403f77c2193da671790c1a242d0b43ac6f570e5047993ef745d13d6376b57b",
"MsgType": 51,
"Content": "<msg>
<op id='5'>
<username>wxid_e602if1itlm821</username>
</op>
</msg>",
"Status": 3,
"ImgStatus": 1,
"CreateTime": 1476612570,
"VoiceLength": 0,
"PlayLength": 0,
"FileName": "",
"FileSize": "",
"MediaId": "",
"Url": "",
"AppMsgType": 0,
"StatusNotifyCode": 5,
"StatusNotifyUserName": "@e5403f77c2193da671790c1a242d0b43ac6f570e5047993ef745d13d6376b57b",
"RecommendInfo": {
"UserName": "",
"NickName": "",
"QQNum": 0,
"Province": "",
"City": "",
"Content": "",
"Signature": "",
"Alias": "",
"Scene": 0,
"VerifyFlag": 0,
"AttrStatus": 0,
"Sex": 0,
"Ticket": "",
"OpCode": 0
},
"ForwardFlag": 0,
"AppInfo": {
"AppID": "",
"Type": 0
},
"HasProductId": 0,
"Ticket": "",
"ImgHeight": 0,
"ImgWidth": 0,
"SubMsgType": 0,
"NewMsgId": 8410419333108272000
}
],
"ModContactCount": 0,
"ModContactList": [],
"DelContactCount": 0,
"DelContactList": [],
"ModChatRoomMemberCount": 0,
"ModChatRoomMemberList": [],
"Profile": {
"BitFlag": 0,
"UserName": {
"Buff": ""
},
"NickName": {
"Buff": ""
},
"BindUin": 0,
"BindEmail": {
"Buff": ""
},
"BindMobile": {
"Buff": ""
},
"Status": 0,
"Sex": 0,
"PersonalCard": 0,
"Alias": "",
"HeadImgUpdateFlag": 0,
"HeadImgUrl": "",
"Signature": ""
},
"ContinueFlag": 0,
"SyncKey": {
"Count": 10,
"List": [
{
"Key": 1,
"Val": 643606091
}
..... //同步key
]
},
"SKey": "",
"SyncCheckKey": {
"Count": 10,
"List": [
{
"Key": 1,
"Val": 643606091
}
..... //同步检测消息key
]
}
}
```
### 7.webwxstatreport(post):
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxstatreport?fun=new&lang=zh_CN
登录前和登录后都有，可能是用来统计用的，不影响其他获取信息，暂时不用对次请求进行处理
#### 请求头：
Content-Type:application/json;charset=UTF-8
## 微信网页版协议分析（3）-消息接口
### 1.发文字消息（post）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsg?lang=zh_CN&pass_ticket=tM909DkHH8fXLR7hhwIgn9MqmSuCxx6%252BcdaA9qE203zxP7fMT%252FtxPlY7opbnnVE2
#### 参数
```
lang=zh_CN 语言
pass_ticket 登录后返回信息中获取
```
#### 请求头：
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"BaseRequest": {
"Uin": 566148615,
"Sid": "2qui+CC4YTiiI2zk",
"Skey": "@crypt_14ae1b12_1bb5e370393b8cd502919825fe9dbfc0",
"DeviceID": "e784205590563506"
},
"Msg": {
"Type": 1,
"Content": "@啊啊啊 啊啊啊啊啊啊",
"FromUserName": "@595d9f44c64e2f480baa0d6430ca58ef053a768daa6d7b3fcc4bece244bcbce3",
"ToUserName": "@@9e1c0ab62b5ab222835786c00192fb1e10c75f8082c245d360ac6a6bd2efe2df",
"LocalID": "14766146756340722",
"ClientMsgId": "14766146756340722"
},
"Scene": 0
}
Type: 1 文字消息,
Content: 要发送的消息,
FromUserName: 自己ID,
ToUserName: 好友ID,
LocalID: 与clientMsgId相同,
ClientMsgId: 时间戳左移4位随后补上4位随机数
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"MsgID": "4527210051674039705",
"LocalID": "14766146756340722"
}
```
### 2.发送表情消息（post）:
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendemoticon?fun=sys&lang=zh_CN
#### 请求头：
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"BaseRequest": {
"Uin": 566148615,
"Sid": "2qui+CC4YTiiI2zk",
"Skey": "@crypt_14ae1b12_1bb5e370393b8cd502919825fe9dbfc0",
"DeviceID": "e961665475339031"
},
"Msg": {
"Type": 47,
"EmojiFlag": 2,
"EMoticonMd5": "44682e637b75a3f5d6747d61dbd23a15",
"FromUserName": "@595d9f44c64e2f480baa0d6430ca58ef053a768daa6d7b3fcc4bece244bcbce3",
"ToUserName": "@e5403f77c2193da671790c1a242d0b43ac6f570e5047993ef745d13d6376b57b",
"LocalID": "14766150190560991",
"ClientMsgId": "14766150190560991"
},
"Scene": 0
}
Type: 47 emoji消息,
EmojiFlag: 2,
MediaId: 表情上传后的媒体ID,
FromUserName: 自己ID,
ToUserName: 好友ID,
LocalID: 与clientMsgId相同,
ClientMsgId: 时间戳左移4位随后补上4位随机数
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"MsgID": "1604548346807369725",
"LocalID": "14766150190560991"
}
```
### 3.发送图片消息：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsgimg?fun=async&f=json&lang=zh_CN
#### 请求头：
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"BaseRequest": {
"Uin": 566148615,
"Sid": "2qui+CC4YTiiI2zk",
"Skey": "@crypt_14ae1b12_1bb5e370393b8cd502919825fe9dbfc0",
"DeviceID": "e374531581999650"
},
"Msg": {
"Type": 3,
"MediaId": "@crypt_4d268bd0",
"FromUserName": "@595d9f44c64e2f480baa0d6430ca58ef053a768daa6d7b3fcc4bece244bcbce3",
"ToUserName": "@e5403f77c2193da671790c1a242d0b43ac6f570e5047993ef745d13d6376b57b",
"LocalID": "14766158484990338",
"ClientMsgId": "14766158484990338"
},
"Scene": 0
}
Type: 3 媒体消息,
MediaId: 表情上传后的媒体ID,
FromUserName: 自己ID,
ToUserName: 好友ID,
LocalID: 与clientMsgId相同,
ClientMsgId: 时间戳左移4位随后补上4位随机数
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"MsgID": "6722400141243782346",
"LocalID": "14766158484990338"
}
```
### 4.发送文件消息（post）:
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendappmsg?fun=async&f=json
#### 请求头：
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"BaseRequest": {
"Uin": 566148615,
"Sid": "NO0RlTCXvpBGaag7",
"Skey": "@crypt_14ae1b12_3bdec7023595f68f9900b5d9d7d30b75",
"DeviceID": "e984332143788024"
},
"Msg": {
"Type": 6,
"Content": "top10.csv61760@crypt_f672a24d_9d9c7d6a3b5ec058db1e6eb3d7c66917ede2e615535e9659365322de110ac41877d9a3b878ed82c0959f9b4602ef6e6d784ae853ab4e242d201cb19b9ee255a337f884eab998c5c43e7d433c01f14c91csv",
"FromUserName": "@257b5aa7fb7b1672afb889be97197478cf618d9bab2b470cf767a61ae9f7f321",
"ToUserName": "@@ab3e18c922f8ab162762f6da231236137ca52871419ec9cafc2421607e82e1ca",
"LocalID": "14767614604200494",
"ClientMsgId": "14767614604200494"
},
"Scene": 0
}
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"MsgID": "6923581840474342573",
"LocalID": "14767614604200494"
}
```
### 5.上传附件接口（post）：
https://file.wx.qq.com/cgi-bin/mmwebwx-bin/webwxuploadmedia?f=json
#### 请求头：
Content-Type:multipart/form-data; boundary=----WebKitFormBoundaryoWmrkW7MIGyBhlOt
#### 提交参数（表单信息）：
```
id 文件id
name 文件名
type 文件类型
lastModifieDate 最后修改时间
size 文件大小
mediatype 文件媒体类型 doc pic
uploadmediarequest（json字符串）
UploadType 上传类型 2
BaseRequest
Uin 登录中获得
Sid 登录中获得
Skey 登录中获得
DeviceID 设备id
ClientMediaId 文件本地消息id
TotalLen 文件总大小
StartPos 开始位置
DataLen 数据长度
MediaType 媒体类型 4
FromUserName 发送用户id
ToUserName 接受用户id
FileMd5 文件md5
webwx_data_ticket cookie中信息
pass_ticket
filename 文件流
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
}
,
"MediaId": "@crypt_6084141c_c73c046b750fd6e3e82d0aba4839b89b30851de7eace0446a4f73b524e3b43d41b24048e9c10cf7ba3387d04d63e6bd75bf8e3237acdddda5d4e3ede176617370573ebb2f820595076c55906a50a50a7",
"StartPos": 25929,
"CDNThumbImgHeight": 0,
"CDNThumbImgWidth": 0
}
```
### 6.图片接口：
#### 获取消息图片（get）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetmsgimg?&MsgID=6829659093985341608&skey=%40crypt_14ae1b12_1bb5e370393b8cd502919825fe9dbfc0&type=slave
##### 参数
```
MsgID: 消息ID
type: slave 略缩图 or 为空时加载原图
skey: xxx
```
#### 获取联系人头像（get）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgeticon?seq=637275253&username=@aa357b7fc1ccb2e77a2632a6251fb6de2c5dd1c0ec503f04b25cfd34c256956a&skey=@crypt_14ae1b12_1bb5e370393b8cd502919825fe9dbfc0
##### 参数
```
seq: 数字，可为空
username: ID
skey: xxx
```
#### 获取群头像（get）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetheadimg?seq=0&username=@@eca74ece82ad7947d262c59d53ab5d001e8776374141377cc025956b44bd1c03&skey=@crypt_14ae1b12_1bb5e370393b8cd502919825fe9dbfc0
##### 参数
```
seq: 数字，可为空
username: 群ID
skey: xxx
```
### 6.多媒体接口：
#### 获取语音消息（get）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetvoice?msgid=6181125285738858128&skey=@crypt_14ae1b12_1bb5e370393b8cd502919825fe9dbfc0
##### 参数
```
msgid: 消息ID
skey: xxx
```
#### 获取视频消息信息（get）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetvideo?msgid=114757855447263581&skey=%40crypt_14ae1b12_1bb5e370393b8cd502919825fe9dbfc0
##### 参数
```
msgid: 消息ID
skey: xxx
```
#### 获取其他文件：
https://file.wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetmedia?sender=@@aa4d90eee1984452cfacf8b510ce6547af58aa4fe34fe567787c716fd262d42c&mediaid=@crypt_3d1bb9c7_7f07116cc9b86e9d8237ad938293eee8a820acfa35e7bdaa41a03fc2fb17b60a4c6da7f967714259dec587505a1b55b10e61e301f733ec718167d8d355f8809257d3fbf382d775e2872e552957e894d52060d8766133214a58ea017e6416216c9f6f1d6056e5b22fe6c78a50efcf384969a7e1b96f348f581853b41be070c16ea4d510b8d10d747a3fc5a3909e1ed2deea43aa6db558c6dd58d453e8d6235d9f6a7c7bc0eb752fb5aee59568ab8de8ff38e0064b827765ae847d6a3503fba9a970006d18f0092a12811ccaec57c071bd&filename=51CTO%E4%B8%8B%E8%BD%BD-MySQL%E6%80%A7%E8%83%BD%E8%B0%83%E4%BC%98%E4%B8%8E%E6%9E%B6%E6%9E%84%E8%AE%BE%E8%AE%A1.pdf&fromuser=1443149207&pass_ticket=td%252BZEx1ANBEB8wz%252BxjYhotl3fChIto%252FyC4w%252FNHMopoqOP8Eya9%252FivEs2lsPEDqEj&webwx_data_ticket=gSc8PoV98Y4y98pOsP6hmcpj
##### 参数
```
sender 发送者UserName
mediaid 媒体id
filename 文件名
fromuser 接受者UserName
pass_ticket 登录返回信息中
webwx_data_ticket cookie中信息
```
### 7.账号类型
#### 个人账号
以@开头，例如：@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 系统消息
10002 撤回消息
```
##### 微信初始化消息
```
MsgType: 51
FromUserName: 自己ID
ToUserName: 自己ID
StatusNotifyUserName: 最近联系的联系人ID
Content:
// 最近联系的联系人
filehelper,xxx@chatroom,wxid_xxx,xxx,...
// 朋友圈
MomentsUnreadMsgStatus
1454502365
// 未读的功能账号消息，群发助手，漂流瓶等
```
##### 文本消息
```
MsgType: 1
FromUserName: 发送方ID
ToUserName: 接收方ID
Content: 消息内容
图片消息
MsgType: 3
FromUserName: 发送方ID
ToUserName: 接收方ID
MsgId: 用于获取图片
Content:
![]()
```
##### 小视频消息
```
MsgType: 62
FromUserName: 发送方ID
ToUserName: 接收方ID
MsgId: 用于获取小视频
Content:
![]()
```
##### 地理位置消息
```
MsgType: 1
FromUserName: 发送方ID
ToUserName: 接收方ID
Content: http://weixin.qq.com/cgi-bin/redirectforward?args=xxx
// 属于文本消息，只不过内容是一个跳转到地图的链接
```
##### 名片消息
```
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
}
```
##### 语音消息
```
MsgType: 34
FromUserName: 发送方ID
ToUserName: 接收方ID
MsgId: 用于获取语音
Content:
```
##### 动画表情
```
MsgType: 47
FromUserName: 发送方ID
ToUserName: 接收方ID
Content:
```
##### 普通链接或应用分享消息
```
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: 未知
注：根据网页版的代码可以看到未来可能支持查看红包消息，但目前走的是系统消息，见下。
```
##### 系统消息
```
MsgType: 10000
FromUserName: 发送方ID
ToUserName: 自己ID
Content:
"你已添加了 xxx ，现在可以开始聊天了。"
"如果陌生人主动添加你为朋友，请谨慎核实对方身份。"
"收到红包，请在手机上查看"
```
## 微信网页版协议分析（4）-好友操作
### 1.加好友和通过好友验证接口（post）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxverifyuser?r=1476779339614&lang=zh_CN&pass_ticket=td%252BZEx1ANBEB8wz%252BxjYhotl3fChIto%252FyC4w%252FNHMopoqOP8Eya9%252FivEs2lsPEDqEj
#### 请求头：
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
加好友提交的数据
{
"BaseRequest": {
"Uin": 1443149207,
"Sid": "HqU75NIXRJ6qqu8t",
"Skey": "@crypt_d9da2d81_f3a62e80c16e61ad660dffd14e0ef72c",
"DeviceID": "e799452821014375"
},
"Opcode": 2,
"VerifyUserListSize": 1,
"VerifyUserList": [
{
"Value": "@2cbb226c459cc5203aa991942f41e19820f5ef3ccceb2dece598412f36406d1f", "VerifyUserTicket": ""
}
],
"VerifyContent": "我是lbbniu.cn",
"SceneListCount": 1,
"SceneList": [
33
],
"skey": "@crypt_d9da2d81_f3a62e80c16e61ad660dffd14e0ef72c"
}
```
通过好友提交的数据，下面2中获取相关信息
```
{
"BaseRequest": {
"Uin": 1443149207,
"Sid": "HqU75NIXRJ6qqu8t",
"Skey": "@crypt_d9da2d81_f3a62e80c16e61ad660dffd14e0ef72c",
"DeviceID": "e606224692711308"
},
"Opcode": 3,
"VerifyUserListSize": 1,
"VerifyUserList": [
{
"Value": "@2cbb226c459cc5203aa991942f41e19820f5ef3ccceb2dece598412f36406d1f",
"VerifyUserTicket": "v2_9d2e1b01ee6de582a237f6369a6746c84d3a072b48bf36f152c5c947505e871189cafa09748e05bab27caf812a8f3a12d51da3dceda3cab5f52a406ec124a4a9@stranger"
}
],
"VerifyContent": "",
"SceneListCount": 1,
"SceneList": [
33
],
"skey": "@crypt_d9da2d81_f3a62e80c16e61ad660dffd14e0ef72c"
}
```
#### 返回数据（post）：
```
{
"BaseResponse":{
"Ret": 0,
"ErrMsg":""
}
}
```
### 2.好友验证消息体
```
"RecommendInfo": {
"UserName": "@2cbb226c459cc5203aa991942f41e19820f5ef3ccceb2dece598412f36406d1f",
"NickName": "LbbNiu",
"QQNum": 0,
"Province": "",
"City": "æ",
"Content": "",
"Signature": "",
"Alias": "lbbniu",
"Scene": 14,
"VerifyFlag": 0,
"AttrStatus": 4305791,
"Sex": 1,
"Ticket": "v2_9d2e1b01ee6de582a237f6369a6746c84d3a072b48bf36f152c5c947505e871189cafa09748e05bab27caf812a8f3a12d51da3dceda3cab5f52a406ec124a4a9@stranger",
"OpCode": 2
},
```
### 3.创建群聊（post）：
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxcreatechatroom?r=1476618448303&lang=zh_CN
#### 请求头：
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"MemberCount": 3,
"MemberList": [
{
"UserName": "@fe20084fb8e3b488f49d3df2bf3ec2837daeb468abfe62a48ef39a6e407cab0e"
},
....
],
"Topic": "",
"BaseRequest": {
"Uin": 1443149207,
"Sid": "HqU75NIXRJ6qqu8t",
"Skey": "@crypt_d9da2d81_f3a62e80c16e61ad660dffd14e0ef72c",
"DeviceID": "e280173725621646"
}
}
UserName 初始化接口中获取
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": "Everything is OK"
},
"Topic": "",
"PYInitial": "",
"QuanPin": "",
"MemberCount": 3,
"MemberList": [
{
"Uin": 0,
"UserName": "@fe20084fb8e3b488f49d3df2bf3ec2837daeb468abfe62a48ef39a6e407cab0e",
"NickName": "111111",
"AttrStatus": 0,
"PYInitial": "",
"PYQuanPin": "",
"RemarkPYInitial": "",
"RemarkPYQuanPin": "",
"MemberStatus": 0,
"DisplayName": "",
"KeyWord": ""
},
...
],
"ChatRoomName": "@@45340ba1e520285af196cef99d2f41a2bdb5cc568569efa178354f08eb863d00",
"BlackList": ""
}
```
### 4.群中踢出好友接口
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxupdatechatroom?fun=delmember
#### 请求头：
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"DelMemberList": "@2cbb226c459cc5203aa991942f41e19820f5ef3ccceb2dece598412f36406d1f",
"ChatRoomName": "@@45340ba1e520285af196cef99d2f41a2bdb5cc568569efa178354f08eb863d00",
"BaseRequest": {
"Uin": 1443149207,
"Sid": "HqU75NIXRJ6qqu8t",
"Skey": "@crypt_d9da2d81_f3a62e80c16e61ad660dffd14e0ef72c",
"DeviceID": "e934789096108643"
}
}
DelMemberList 好友id
ChatRoomName 群组id
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
}
,
"MemberCount": 0,
"MemberList": []
}
```
### 5.邀请好友加入群
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxupdatechatroom?fun=addmember
#### 请求头
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"AddMemberList": "@2cbb226c459cc5203aa991942f41e19820f5ef3ccceb2dece598412f36406d1f",
"ChatRoomName": "@@45340ba1e520285af196cef99d2f41a2bdb5cc568569efa178354f08eb863d00",
"BaseRequest": {
"Uin": 1443149207,
"Sid": "HqU75NIXRJ6qqu8t",
"Skey": "@crypt_d9da2d81_f3a62e80c16e61ad660dffd14e0ef72c",
"DeviceID": "e681854808526145"
}
}
AddMemberList 好友id列表
ChatRoomName 群组id
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"MemberCount": 1,
"MemberList": [
{
"Uin": 0,
"UserName": "@2cbb226c459cc5203aa991942f41e19820f5ef3ccceb2dece598412f36406d1f",
"NickName": "LbbNiu",
"AttrStatus": 0,
"PYInitial": "",
"PYQuanPin": "",
"RemarkPYInitial": "",
"RemarkPYQuanPin": "",
"MemberStatus": 0,
"DisplayName": "",
"KeyWord": ""
}
...
]
}
```
### 6.修改群名称
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxupdatechatroom?fun=modtopic
#### 请求头
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"NewTopic": "lbbniu.com",
"ChatRoomName": "@@45340ba1e520285af196cef99d2f41a2bdb5cc568569efa178354f08eb863d00",
"BaseRequest": {
"Uin": 1443149207,
"Sid": "HqU75NIXRJ6qqu8t",
"Skey": "@crypt_d9da2d81_f3a62e80c16e61ad660dffd14e0ef72c",
"DeviceID": "e326783138505913"
}
}
NewTopic 新群名称
ChatRoomName 群组id
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
}
,
"MemberCount": 0,
"MemberList": []
}
```
### 7.置顶聊天会话
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxoplog
#### 请求头
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"UserName": "@@45340ba1e520285af196cef99d2f41a2bdb5cc568569efa178354f08eb863d00",
"CmdId": 3,
"OP": 1,
"BaseRequest": {
"Uin": 1443149207,
"Sid": "HqU75NIXRJ6qqu8t",
"Skey": "@crypt_d9da2d81_f3a62e80c16e61ad660dffd14e0ef72c",
"DeviceID": "e736741369963778"
}
}
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
}
}
```
### 8.取消置顶聊天会话
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxoplog
#### 请求头
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"UserName": "@@45340ba1e520285af196cef99d2f41a2bdb5cc568569efa178354f08eb863d00",
"CmdId": 3,
"OP": 0,
"BaseRequest": {
"Uin": 1443149207,
"Sid": "HqU75NIXRJ6qqu8t",
"Skey": "@crypt_d9da2d81_f3a62e80c16e61ad660dffd14e0ef72c",
"DeviceID": "e736741369963778"
}
}
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
}
}
```
### 9.给好友添加备注
https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxoplog
#### 请求头
Content-Type:application/json;charset=UTF-8
#### 提交数据（json）：
```
{
"UserName": "@2cbb226c459cc5203aa991942f41e19820f5ef3ccceb2dece598412f36406d1f",
"CmdId": 2,
"RemarkName": "lbbniu.com",
"BaseRequest": {
"Uin": 1443149207,
"Sid": "HqU75NIXRJ6qqu8t",
"Skey": "@crypt_d9da2d81_f3a62e80c16e61ad660dffd14e0ef72c",
"DeviceID": "e573447900268361"
}
}
```
#### 返回数据（json）：
```
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
}
}
```