2
0
mirror of https://gitee.com/hotlcc/wechat4j.git synced 2025-06-06 10:34:07 +08:00

提交代码:更新web微信api文档

This commit is contained in:
Allen 2018-09-14 16:15:35 +08:00
parent 59a95df99a
commit ab094dad76

View File

@ -158,7 +158,7 @@ URL参数分析
FORM表单参数分析
|数名|示例值|描述|
|数名|示例值|描述|
|---|---|---|
|sid||登录时获取的;|
|uin||登录时获取的;|
@ -996,3 +996,128 @@ POST参数分析
```
https://file.wx.qq.com/cgi-bin/mmwebwx-bin/webwxuploadmedia?f=json
```
若文件较小则只会产生一个该请求若文件较大则会产生多个该请求。多个请求表示以分片的方式发送文件数据分片大小约为524288。
FORM表单参数分析
|参数名|示例值|描述|
|---|---|---|
|~~id~~|WU_FILE_0|页面文件组件ID非必须|
|~~name~~|bd00c8eed5c2cd522e69f38317b46903.jpg|文件名;非必须;|
|~~type~~|image/jpeg|文件的MimeType非必须|
|~~lastModifieDate~~||文件最后修改时间;非必须;|
|~~size~~|99785|文件大小;非必须;|
|chunks|3|文件分片数量;文件较大需要分片时必须;|
|chunk|0|文件分片序号从0开始文件较大需要分片时必须|
|mediatype|pic|文件类型图片为pic其它文件为doc非必须|
|uploadmediarequest||JSON字符串必须|
|webwx_data_ticket||cookie中的数据必须|
|pass_ticket||登录时获取的;必须;|
|filename||文件二进制数据;必须;|
uploadmediarequest结构示例
```json
{
"UploadType": 2,
"BaseRequest": {
"Uin": 1245,
"Sid": "zxaODbK4ed",
"Skey": "@crypt_4f399da_3c7a87e93b7872bce",
"DeviceID": "e69688819413"
},
"ClientMediaId": 153686311,
"TotalLen": 87508,
"StartPos": 0,
"DataLen": 87508,
"MediaType": 4,
"FromUserName": "@6feb88ee01067121479f686",
"ToUserName": "@6feb88ee0106f67121479f686",
"FileMd5": "717d1dbb9833c7cdbdd09ac"
}
```
服务端返回数据:
```json
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"MediaId": "@crypt_17ab5.................39bd9cfa9ab",
"StartPos": 99785,
"CDNThumbImgHeight": 56,
"CDNThumbImgWidth": 100,
"EncryFileName": "bd00c8e.....38317b46903.jpg"
}
```
上传成功后返回数据中会有MediaId如果是分片上传的则最后一个请求会返回MediaId。
### 4.4、上传媒体到服务器
发送图片后紧接着4.3的是如下POST请求
```
https://wx2.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsgimg?fun=async&f=json&lang=zh_CN&pass_ticket=xFAjPcq0eXh.......TYHHdHgVL52eHo%253D
```
URL参数分析
|数名|示例值|描述|
|---|---|---|
|pass_ticket|xFAjPcq0eXh.......TYHHdHgVL52eHo%253D|同前面获取的;|
POST的数据JSON
```json
{
"BaseRequest": {
"Uin": 16...245,
"Sid": "KvCP..../TNqh8",
"Skey": "@crypt_4fb399da......9f1b3d997c4b5eef82",
"DeviceID": "e2825...3652448"
},
"Msg": {
"Type": 3,
"MediaId": "@crypt_17ab5.................39bd9cfa9ab",
"Content": "",
"FromUserName": "@3641f45.......69bed57642",
"ToUserName": "@3641f454....9bed57642",
"LocalID": "153691....0527",
"ClientMsgId": "1536....390527"
},
"Scene": 0
}
```
POST参数分析
|Key|示例值|描述|
|---|---|---|
|BaseRequest||同上;|
|Msg.ClientMsgId||同LocalID|
|Msg.Content||消息内容消息为媒体时该值为媒体ID。|
|Msg.FromUserName||发送用户;|
|Msg.LocalID||13位时间戳+4位随机数|
|Msg.ToUserName||接收用户;|
|Msg.Type|3|消息类型同3.1中接收的消息类型;|
|Msg.MediaId||4.3接口中返回的MediaId|
|Scene|0|固定值;|
服务端返回数据:
```json
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"MsgID": "28832......8291836",
"LocalID": "1536.....54390527"
}
```
Web微信发送图片需要先调4.3的接口将媒体文件上传到服务器然后再调4.4的接口发送图片的相关信息。