微信网页版API接口详解

✨ AI 智能摘要

AI 正在生成文章简介，请稍候...

1、获取uuid#

说明：用于获取显示二维码以及登录所需的uuid，标识获取二维码和扫码的为同一个用户
请求方式：GET
地址：https://login.weixin.qq.com/jslogin
get参数： | 参数 | 示例值 |说明 | | ------- | ------- |------- | | appid | wx782c26e4c19acffb | 固定值 | | fun | new | 固定值 | | lang | zh_CN | 表示中文字符集 |
返回:

1
window.QRLogin.code = 200; window.QRLogin.uuid = "xxx"

注：这里的appid就是在微信开放平台注册的应用的AppID。网页版微信有两个AppID，早期的是wx782c26e4c19acffb，在微信客户端上显示为应用名称为Web微信；现在用的是wxeb7ec651dd0aefa9，显示名称为微信网页版。

2、生成登陆二维码#

说明：展示一张用于登陆的二维码图片，地址里的**{uuid}传第一步所获取的uuid**
请求方式：GET
地址：https://login.wx.qq.com/qrcode/{uuid}
get参数： | 参数 | 示例值 |说明 | | ------- | ------- |------- | | t | webwx | 固定值(亲测可以留空) |
返回：二维码的二进制流，浏览器打开会直接显示一张二维码图片

3、轮询二维码扫描登录接口#

说明：尝试登录。若此时用户手机已完成扫码并点击登录，则返回一个真正用于登录的url地址。否则接口大概10s后返回未扫码或未登录的状态码
请求方式：GET
地址：https://login.wx.qq.com/cgi-bin/mmwebwx-bin/login
get参数： | 参数 | 示例值 |说明 | | ------- | ------- |------- | | tip | 1 | 1：未扫描 0：一扫描 | | uuid | xxx | 第一步所获取的uuid |
返回：redirect_uri的值可以直接用于下一步的“登录并获取公参”请求

1
window.code=xxx;
2
xxx:
3
  408 登陆超时
4
  201 扫描成功
5
  200 确认登录
6
当返回200时，还会有如下内容
7
window.redirect_uri="https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage?ticket=xxx&uuid=xxx&lang=xxx&scan=xxx";

4、登录并获取公参#

说明：访问后可获取一组公参，用于之后访问所有的接口。这也意味着如果这部分数据泄露，代表其他人可以在这段时间内随意操作你的微信（仅限于网页版支持的操作）
请求方式：GET
地址：https://wx2.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage
get参数： | 参数 | 示例值 | | ------- | ------- | | params | ticket: xxx
uuid: xxx
lang: zh_CN 语言
scan: xxx
fun: new 必填 |
返回：获取并存储该返回值中的四个参数skey、wxsid、wxuin、pass_ticket，以及所返回Cookie中的webwx_data_ticket，webwx_auth_ticket

1
<error>
2
  <ret>0</ret>
3
  <message>OK</message>
4
  <skey>xxx</skey>
5
  <wxsid>xxx</wxsid>
6
  <wxuin>xxx</wxuin>
7
  <pass_ticket>xxx</pass_ticket>
8
  <isgrayscale>1</isgrayscale>
9
</error>

skey wxsid wxuin pass_ticket webwx_data_ticket webwx_auth_ticket 保存全局跟本地，下次打开直接使用，不用扫码登陆。

5、微信初始化#

说明：初始化微信首页栏的联系人、公众号等（不是通讯录里的联系人），初始化登录者自己的信息（包括昵称等），初始化同步消息所用的SycnKey
请求方式：POST
类型：JSON
请求头：ContentType: application/json; charset=UTF-8
地址：https://wx2.qq.com/cgi-bin/mmwebwx-bin/webwxinit
get参数： | 参数 | 示例值 |说明 | | ------- | ------- |------- | | pass_ticket | qg%2BL%2BfjNnoHyqYsL3xj0KoNi5nqchsInPWWSxDwqCJ8%3D |公参中的值 |
post参数json：

1
{
2
    BaseRequest: {
3
        Uin: 211722515，
4
        Sid: +urBrYI292xoIknf，
5
        Skey: @crypt_8b4f09cc_a5871dc10130a48703b9afd5602152e4，
6
        DeviceID: e545297464380306
7
    //上边的DeviceID是设备id（自行生成跟保存），每次登录过程中保持一致。
8
    }
9
}

返回json：

1
{
2
  "BaseResponse": {
3
    "Ret": 0,
4
    "ErrMsg": ""
5
  },
6
  "Count": 11,
7
  "ContactList": [{//微信首页的联系人，不是保存在通讯录中的联系人
8
        "Uin": 0,
9
        "UserName": "filehelper",
10
        "NickName": "文件传输助手",
11
        "HeadImgUrl": "/cgi-bin/mmwebwx-bin/webwxgeticon?seq=680769514&username=filehelper&skey=@crypt_8b4f09cc_a5871dc10130a48703b9afd5602152e4",
12
        "ContactFlag": 1,
13
        "MemberCount": 0,
14
        "MemberList": [],
15
        "RemarkName": "",
16
        "HideInputBarFlag": 0,
17
        "Sex": 0,
18
        "Signature": "",
19
        "VerifyFlag": 0,
20
        "OwnerUin": 0,
21
        "PYInitial": "WJCSZS",
22
        "PYQuanPin": "wenjianchuanshuzhushou",
23
        "RemarkPYInitial": "",
24
        "RemarkPYQuanPin": "",
25
        "StarFriend": 0,
26
        "AppAccountFlag": 0,
27
        "Statues": 0,
28
        "AttrStatus": 0,
29
        "Province": "",
30
        "City": "",
31
        "Alias": "",
32
        "SnsFlag": 0,
33
        "UniFriend": 0,
34
        "DisplayName": "",
35
        "ChatRoomId": 0,
36
        "KeyWord": "fil",
37
        "EncryChatRoomId": "",
38
        "IsOwner": 0
39
    },
40
        //......此处省略剩下的10个联系人信息
41
    ],
42
  "SyncKey": {//同步消息时用的syncKey，用于之后轮询消息的接口
43
    "Count": 4,
44
    "List": [
45
      {
46
        "Key": 1,
47
        "Val": 635705559
48
      },
49
      //...此处省略剩下的3条信息
50
    ]
51
  },
52
  "User": {//登录者的信息
53
    "Uin": xxx,
54
    "UserName": xxx,//微信随机码，每个联系人和群都有，每次登录由微信端随机分配
55
    "NickName": xxx,
56
    "HeadImgUrl": xxx,
57
    "RemarkName": "",
58
    "PYInitial": "",
59
    "PYQuanPin": "",
60
    "RemarkPYInitial": "",
61
    "RemarkPYQuanPin": "",
62
    "HideInputBarFlag": 0,
63
    "StarFriend": 0,
64
    "Sex": 1,
65
    "Signature": "这里是签名",
66
    "AppAccountFlag": 0,
67
    "VerifyFlag": 0,
68
    "ContactFlag": 0,
69
    "WebWxPluginSwitch": 0,
70
    "HeadImgFlag": 1,
71
    "SnsFlag": 17
72
  },
73
  "ChatSet": xxx,
74
  "SKey": xxx,
75
  "ClientVersion": 369297683,
76
  "SystemTime": 1453124908,
77
  "GrayScale": 1,
78
  "InviteStartCount": 40,
79
  "MPSubscribeMsgCount": 2,
80
  "MPSubscribeMsgList": [...],
81
  "ClickReportInterval": 600000
82
}

6、获取联系人列表#

说明：获取手机通讯录中的所有联系人（包括人、群、公众号等）
请求方式：POST
类型：JSON
请求头：ContentType: application/json; charset=UTF-8
地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetcontact
get参数： | 参数 | 示例值 |说明 | | ------- | ------- |------- | | pass_ticket | qg%2BL%2BfjNnoHyqYsL3xj0KoNi5nqchsInPWWSxDwqCJ8%3D |公参中的值 | | skey | @crypt_8b4f09cc_1b827f84b1535b6be801f00427499050 |公参中的值 |
post参数json：

1
{
2
    BaseRequest: {
3
        Uin: 211722515，
4
        Sid: +urBrYI292xoIknf，
5
        Skey: @crypt_8b4f09cc_a5871dc10130a48703b9afd5602152e4，
6
        DeviceID: e545297464380306
7
    //上边的DeviceID是设备id（自行生成跟保存），每次登录过程中保持一致。
8
    }
9
}

返回json：

1
{
2
  "BaseResponse": {
3
    "Ret": 0,
4
    "ErrMsg": ""
5
  },
6
  "MemberCount": 334,
7
  "MemberList": [
8
    {
9
      "Uin": 0,
10
      "UserName": xxx,//微信随机码，潜规则：前面@为联系人，@@为群
11
      "NickName": "Urinx",//联系人的微信昵称
12
      "HeadImgUrl": xxx,
13
      "ContactFlag": 3,
14
      "MemberCount": 0,//如果是群，该字段表示成员数量
15
      "MemberList": [],//群成员列表
16
      "RemarkName": "",//备注名称，如果空则说明没有给他备注
17
      "HideInputBarFlag": 0,
18
      "Sex": 0,//性别，1为男，2为女
19
      "Signature": "你好，我们是地球三体组织。在这里，你将感受到不一样的思维模式，以及颠覆常规的世界观。而我们的目标，就是以三体人的智慧，引领人类未来科学技术500年。",//签名
20
      "VerifyFlag": 8,//用来判断是否是公众号或服务号的字段
21
      "OwnerUin": 0,
22
      "PYInitial": "URINX",
23
      "PYQuanPin": "Urinx",//名字拼音全拼
24
      "RemarkPYInitial": "",
25
      "RemarkPYQuanPin": "",
26
      "StarFriend": 0,
27
      "AppAccountFlag": 0,
28
      "Statues": 0,
29
      "AttrStatus": 0,
30
      "Province": "",//省份
31
      "City": "",//城市
32
      "Alias": "Urinxs",
33
      "SnsFlag": 0,
34
      "UniFriend": 0,
35
      "DisplayName": "",//如果是群内成员，该字段表示群内名称
36
      "ChatRoomId": 0,
37
      "KeyWord": "gh_",
38
      "EncryChatRoomId": "",//如果是群，该字段表示群的id，不同于微信随机码@@那个
39
      "IsOwner": 0
40
    },
41
    ...
42
  ],
43
  "Seq": 0
44
}

VerifyFlag == 0 是联系人，其他自行分析。

7、消息检查#

说明：同步消息检查。这里只做检查不做同步，如果检查出有新消息，再掉具体同步的接口。
请求方式：GET
地址：https://webpush2.weixin.qq.com/cgi-bin/mmwebwx-bin/synccheck
get参数： | 参数 | 示例值 |说明 | | ------- | ------- |------- | | deviceid | e545297464380306 |公参中的值 | | sid | @crypt_8b4f09cc_1b827f84b1535b6be801f00427499050 |公参中的值 | | skey | +FhlgkGS3wD/GKQw |公参中的值 | | synckey | 1_700722177|2_700724323|3_700724315|1000_1520925834 |微信初始化后获取的4个key，这些key会随着每次获取最新消息（参见9）后的返回值更新，其目的在于每次同步消息后记录一个当前同步的状态。 | | uin | 211722515 |公参中的值 | | r | 1648736166 |时间戳 |
返回：

1
window.synccheck={retcode:"xxx",selector:"xxx"}
2
retcode:
3
  0 正常
4
  -14 ticket错误
5
  1 传入参数错误
6
  1100 失败/登出微信
7
  1101 未检测到登录
8
  1102 cookie值无效
9
  1203 当前登录环境异常，为了安全起见请不要在web端进行登录
10
  1205 操作频繁
11
selector:
12
  0 正常
13
  2 有新消息
14
  4 有人修改了自己的昵称或你修改了别人的备注
15
  6 存在删除或者新增的好友信息
16
  7 进入/离开聊天界面

8、获取最新消息#

说明：当同步检查接口显示有新消息时，调用该接口获取具体的新消息。此处的新消息为广义的，包括消息，修改群名，群内成员变化，加好友等。
请求方式：POST
类型：JSON
请求头：ContentType: application/json; charset=UTF-8
地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsync
get参数： | 参数 | 示例值 |说明 | | ------- | ------- |------- | | sid | @crypt_8b4f09cc_1b827f84b1535b6be801f00427499050 |公参中的值 | | skey | +FhlgkGS3wD/GKQw |公参中的值 | | pass_ticket | yp5RfCpb%2FsNVex0Uepn1BWXNCYCqTfqe8NOYzan%2B4Y4%3D |公参中的值 |
post参数json：

1
{
2
    "BaseRequest": {
3
        "Uin": 211722515,
4
        "Sid": "+FhlgkGS3wD/GKQw",
5
        "Skey": "@crypt_8b4f09cc_1b827f84b1535b6be801f00427499050",
6
        "DeviceID": "e304534670317808"
7
    },
8
    "SyncKey": {
9
        "Count": 4,
10
        "List": [{
11
            "Key": 1,
12
            "Val": 700722177
13
        }, {
14
            "Key": 2,
15
            "Val": 700724323
16
        }, {
17
            "Key": 3,
18
            "Val": 700724315
19
        }, {
20
            "Key": 1000,
21
            "Val": 1520925834
22
        }]
23
    },
24
     rr: -1648736166//时间戳取反
25
}

返回：主要有AddMsgList，ModContactList，DelContactList，新一轮消息同步的synckey

1
{
2
    "BaseResponse": {
3
        "Ret": 0,
4
        "ErrMsg": ""
5
    },
6
    "AddMsgCount": 1, //新增信息
7
    "AddMsgList": [{
8
        "MsgId": "320984672637990367", //服务端返回的消息id，可用于撤回接口参数。如果是图片，该参数还可以作为调用微信获取图片接口的参数之一。
9
        "FromUserName": "@abf90232027117affa7f0c0df3d1bf20", //发消息的人
10
        "ToUserName": "@abf90232027117affa7f0c0df3d1bf20", //发给谁
11
        "MsgType": 51, //消息类型，1为文字，3为图片，34为语音...，具体请自行测试分析
12
        "Content": "",
13
        "Status": 3,
14
        "ImgStatus": 1,
15
        "CreateTime": 1520927383,
16
        "VoiceLength": 0,
17
        "PlayLength": 0,
18
        "FileName": "",
19
        "FileSize": "",
20
        "MediaId": "",
21
        "Url": "",
22
        "AppMsgType": 0,
23
        "StatusNotifyCode": 4,
24
        "ForwardFlag": 0,
25
        "AppInfo": {
26
            "AppID": "",
27
            "Type": 0
28
        },
29
        "HasProductId": 0,
30
        "Ticket": "",
31
        "ImgHeight": 0,
32
        "ImgWidth": 0,
33
        "SubMsgType": 0,
34
        "NewMsgId": 320984672637990367,
35
        "OriContent": "",
36
        "EncryFileName": ""
37
    }],
38
    "ModContactCount": 0, //联系人修改
39
    "ModContactList": [],
40
    "DelContactCount": 0, //联系人删除
41
    "DelContactList": [],
42
    "ModChatRoomMemberCount": 0, //群内成员变动
43
    "ModChatRoomMemberList": [],"ContinueFlag": 0,
44
    "SyncKey": { //新一轮消息更新用这些SyncKey
45
        "Count": 7,
46
        "List": [{
47
            "Key": 1,
48
            "Val": 700722177
49
        }, {
50
            "Key": 2,
51
            "Val": 700724325
52
        }, {
53
            "Key": 3,
54
            "Val": 700724315
55
        }, {
56
            "Key": 11,
57
            "Val": 700724093
58
        }, {
59
            "Key": 201,
60
            "Val": 1520927383
61
        }, {
62
            "Key": 1000,
63
            "Val": 1520925834
64
        }, {
65
            "Key": 1001,
66
            "Val": 1520917874
67
        }]
68
    },
69
    "SKey": "",
70
    "SyncCheckKey": { //新一轮消息同步用这些Key
71
        "Count": 7,
72
        "List": [{
73
            "Key": 1,
74
            "Val": 700722177
75
        }, {
76
            "Key": 2,
77
            "Val": 700724325
78
        }, {
79
            "Key": 3,
80
            "Val": 700724315
81
        }, {
82
            "Key": 11,
83
            "Val": 700724093
84
        }, {
85
            "Key": 201,
86
            "Val": 1520927383
87
        }, {
88
            "Key": 1000,
89
            "Val": 1520925834
90
        }, {
91
            "Key": 1001,
92
            "Val": 1520917874
93
        }]
94
    }
95
}

9、发送消息#

说明：发送文本消息（包括表情），不能发送图片或文件。
请求方式：POST
类型：JSON
请求头：ContentType: application/json; charset=UTF-8
地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsg
get参数： | 参数 | 示例值 |说明 | | ------- | ------- |------- | | pass_ticket | yp5RfCpb%2FsNVex0Uepn1BWXNCYCqTfqe8NOYzan%2B4Y4%3D |公参中的值 |
post参数json：

1
{
2
    "BaseRequest": {
3
        "Uin": 211722515,
4
        "Sid": "+FhlgkGS3wD/GKQw",
5
        "Skey": "@crypt_8b4f09cc_1b827f84b1535b6be801f00427499050",
6
        "DeviceID": "e107694022625701"
7
    },
8
    "Msg": {
9
        "Type": 1,
10
        "Content": "呵呵",
11
        "FromUserName": "@abf90232027117affa7f0c0df3d1bf20",
12
        "ToUserName": "filehelper",
13
        "LocalID": "15209344559450477", //时间戳左移4位随后补上4位随机数
14
        "ClientMsgId": "15209344559450477",
15
    //"MediaId": "" //如果是图片才传这个值
16
    },
17
    "Scene": 0
18
}

1
{
2
    "BaseResponse": {
3
        "Ret": 0,
4
        "ErrMsg": ""
5
    },
6
    "MsgID": "7615282929538795099", //服务端返回的消息id，可用于撤回等接口的参数
7
    "LocalID": "15209344559450477" //本地的消息id，是你自己发请求时的参数
8
}

10、获取消息图片#

说明：调用改接口显示消息里面的图片
请求方式：GET
地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetmsgimg
get参数： | 参数 | 示例值 |说明 | | ------- | ------- |------- | | MsgID | 3176600141007621447 | 服务端返回的消息ID | | type | slave | 略缩图，留空加载原图 | | skey | @crypt_8b4f09cc_1b827f84b1535b6be801f00427499050 | 公参中的值 |
返回：二维码的二进制流，浏览器打开会直接显示一张二维码图片

11、获取消息语音#

说明：调用改接口显示消息里面的语音音频
请求方式：GET
地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetvoice
get参数： | 参数 | 示例值 |说明 | | ------- | ------- |------- | | MsgID | 3176600141007621447 | 服务端返回的消息ID | | skey | @crypt_8b4f09cc_1b827f84b1535b6be801f00427499050 | 公参中的值 |
返回：二维码的二进制流，浏览器打开会直接播放语音