微信网页版接口详解

最新推荐文章于 2024-08-23 20:27:48 发布
最新推荐文章于 2024-08-23 20:27:48 发布
阅读量2.9k 收藏 2
点赞数
文章标签： 前端 json ViewUI
原文链接：http://www.cnblogs.com/flashsun/p/8493306.html
版权

本系列会讲述微信机器人技术的实现，第一讲主要了解微信网页版给我们提供的http接口，这一步是做一个基于微信网页版机器人的基础和难点。

本讲将微信网页版的主要接口罗列出，并给出了入参和返回值的含义和用法。一些不常用的接口后续会逐渐补充，也欢迎大家与我交流。

后面几讲将会在代码中探讨微信机器人的设计思路，欢迎大家持续关注。

 一、网页版微信提供的HTTP接口

1、获取uuid

  • 说明：用于获取显示二维码以及登录所需的uuid，标识获取二维码和扫码的为同一个用户
  • 请求方式：GET
  • 地址：https://login.wx.qq.com/jslogin
  • get参数：
  • 参数示例值说明
    appidwx782c26e4c19acffb固定值
    funnew固定值
    langzh_CN表示中文字符集
  • 返回： 
    window.QRLogin.code = 200; window.QRLogin.uuid = "wb7R2kx9dA==";

2、显示二维码

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

3、轮询登录

  • 说明：尝试登录。若此时用户手机已完成扫码并点击登录，则返回一个真正用于登录的url地址。否则接口大概10s后返回未扫码或未登录的状态码
  • 请求方式：GET
  • 地址：https://login.wx.qq.com/cgi-bin/mmwebwx-bin/login
  • get参数：
  • 参数示例值说明
    tip11：未扫描 0：一扫描
    uuidwb7R2kx9dA==第一步所获取的uuid
  • 返回：redirect_uri的值可以直接用于下一步的“登录并获取公参”请求
    window.code=200（408为未扫码，201为已扫码但未点击登录，200为成功登录）;window.redirect_uri="https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage?ticket=AfrMMbhsnElmA7xc1R9CWUq-@qrticket_0&uuid=4ZnG7WZ0Cg==&lang=zh_CN&scan=1520738372";

4、登录并获取公参

  • 说明：访问后可获取一组公参，用于之后访问所有的接口。这也意味着如果这部分数据泄露，代表其他人可以在这段时间内随意操作你的微信（仅限于网页版支持的操作）
  • 请求方式：GET
  • 地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage
  • get参数：直接用上一步返回的redirect_uri中的所有参数即可
  • 返回：获取并存储该返回值中的四个参数skey、wxsid、wxuin、pass_ticket，以及所返回Cookie中的webwx_data_ticket，webwx_auth_ticket
    <error>
    　　<ret>0</ret>
    　　<message></message>
    　　<skey>@crypt_8b4f09cc_a5871dc10130a48703b9afd5602152e4</skey>
    　　<wxsid>+urBrYI292xoIknf</wxsid>
    　　<wxuin>211722515</wxuin>
    　　<pass_ticket>qg%2BL%2BfjNnoHyqYsL3xj0KoNi5nqchsInPWWSxDwqCJ8%3D</pass_ticket>
    　　<isgrayscale>1</isgrayscale>
    </error>

5、微信初始化

  • 说明：初始化微信首页栏的联系人、公众号等（不是通讯录里的联系人），初始化登录者自己的信息（包括昵称等），初始化同步消息所用的SycnKey
  • 请求方式：POST
  • 地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxinit
  • get参数：
  • 参数示例值说明
    pass_ticketqg%2BL%2BfjNnoHyqYsL3xj0KoNi5nqchsInPWWSxDwqCJ8%3D公参中的值
  • post参数：（json格式）
  • {
    BaseRequest: {
        Uin: 211722515，
        Sid: +urBrYI292xoIknf，
        Skey: @crypt_8b4f09cc_a5871dc10130a48703b9afd5602152e4，
        DeviceID: e545297464380306
    上边的DeviceID可以用如下代码生成，每次登录过程中保持一致。String DeviceID = "e" + String.valueOf(new Random().nextLong()).substring(1, 16);
    }
}
  • 返回：获取并存储该返回值中的四个参数skey、wxsid、wxuin、pass_ticket，以及所返回Cookie中的webwx_data_ticket，webwx_auth_ticket 
    {
    "BaseResponse": {
        "Ret": 0,
        "ErrMsg": ""
    },
    "Count": 11,
    "ContactList": [{微信首页的联系人，不是保存在通讯录中的联系人
        "Uin": 0,
        "UserName": "filehelper",
        "NickName": "文件传输助手",
        "HeadImgUrl": "/cgi-bin/mmwebwx-bin/webwxgeticon?seq=680769514&username=filehelper&skey=@crypt_8b4f09cc_a5871dc10130a48703b9afd5602152e4",
        "ContactFlag": 1,
        "MemberCount": 0,
        "MemberList": [],
        "RemarkName": "",
        "HideInputBarFlag": 0,
        "Sex": 0,
        "Signature": "",
        "VerifyFlag": 0,
        "OwnerUin": 0,
        "PYInitial": "WJCSZS",
        "PYQuanPin": "wenjianchuanshuzhushou",
        "RemarkPYInitial": "",
        "RemarkPYQuanPin": "",
        "StarFriend": 0,
        "AppAccountFlag": 0,
        "Statues": 0,
        "AttrStatus": 0,
        "Province": "",
        "City": "",
        "Alias": "",
        "SnsFlag": 0,
        "UniFriend": 0,
        "DisplayName": "",
        "ChatRoomId": 0,
        "KeyWord": "fil",
        "EncryChatRoomId": "",
        "IsOwner": 0
    }, 
        ......此处省略剩下的10个联系人信息
    ],
    "SyncKey": { 同步消息时用的syncKey，用于之后轮询消息的接口
        "Count": 4,
        "List": [{
            "Key": 1,
            "Val": 700722177
        }, {
            "Key": 2,
            "Val": 700723184
        }, {
            "Key": 3,
            "Val": 700723136
        }, {
            "Key": 1000,
            "Val": 1520723642
        }]
    },
    "User": { 登录者的信息
        "Uin": 211722515,
        "UserName": "@f4c054c78f40743b095b85409dbdc1b3", 微信随机码，每个联系人和群都有，每次登录由微信端随机分配
        "NickName": "测试微信号的昵称",
        "HeadImgUrl": "/cgi-bin/mmwebwx-bin/webwxgeticon?seq=1730335888&username=@f4c054c78f40743b095b85409dbdc1b3&skey=@crypt_8b4f09cc_a5871dc10130a48703b9afd5602152e4",
        "RemarkName": "",
        "PYInitial": "",
        "PYQuanPin": "",
        "RemarkPYInitial": "",
        "RemarkPYQuanPin": "",
        "HideInputBarFlag": 0,
        "StarFriend": 0,
        "Sex": 1,
        "Signature": "这里是签名",
        "AppAccountFlag": 0,
        "VerifyFlag": 0,
        "ContactFlag": 0,
        "WebWxPluginSwitch": 0,
        "HeadImgFlag": 1,
        "SnsFlag": 17
    },
    "ChatSet": "filehelper,weixin,@52d5b97ca1bed2d76b405fba4c4ded6c893bd6b28cc514344dd9a7d8cd766286,@4baf3160e84b9e726efd1a0629d16b01,@@54a4fd2c81875aac779935330b67bf7905793bb66da9c6d4029f18f4927b3c1c,@@9542a551bfcafe1ae83b931d21b318573c8c6e2c67f3eaef189e7e9179cdb2d1,@ac3532106e21aa250cc746055a0c72d5,@d593e5745931641d060cdc9fcda5d996,@34f12e07290f62677137181998bf4c1eb0a9c128f2355562e8cc7967d0f9a044,@@31e445167b2fd23404b672f6f1a4a805fffbd369d6bae8efe959240a6c50cf46,@@c5fa6cb3779e217b5ae3e9b3d53faef09d6cde9615106ebe0a115de38976c7fc,@513fcb83ccc696b9d90206f0e80eb8e341e35e1f464b08446795132d180db040,@@b944058f6fd91b850867bb1f534205e86460b4b3a947f4ca4bd49109e532116f,@@859e98412d1faf03abdf784e97ed66b25c52dccc7ec446d681b2906525262fcd,@257fb1c805c1429ca45a737143d7a7e1302487d9bbb268bf2dd8a564bf814186,filehelper,@@dc3e7f04b1ccead2ecf8c50eaa476d6c71dc3f7396696be0724002e1ee228812,@@d1758feb60b1ff7ad262b8fb05ee9f1c1821722a0376a1431cee351c75cbebc3,@@e49ba13661221be9c9f81fb952391754ee74f98d2457f46364bdb745943b2bfc,@@a5cdd9eb797807cc081bc0e3ab3f101c9dc18d86d527c5defed8e8fd9010ec06,@@dfab3cde2a39ccdf31da803381528f130dae207583a5c088514bf4e1a0af49ab,@@13776e6ea475a8e86a46e4f242917db146664572e910dcca976047cb31e660f4,@@d1999c210e6f9a19d28b4a8fcc391a7b612c9765ff5bd078aaa022e1cc8bbf5c,",
    "SKey": "@crypt_8b4f09cc_ce5178b3c156048fff69cdf1fccc31e4",
    "ClientVersion": 637927733,
    "SystemTime": 1520742050,
    "GrayScale": 1,
    "InviteStartCount": 40,
    "MPSubscribeMsgCount": 1,
    "MPSubscribeMsgList": [{
        "UserName": "@4baf3160e84b9e726efd1a0629d16b01",
        "MPArticleCount": 1,
        "MPArticleList": [{
            "Title": "不动手就能逛淘宝，这又是什么“黑科技”？英国小哥表示：中文说得溜就是这么方便！ | 解码新时代",
            "Digest": "张口说话就能逛淘宝，沉溺“黑科技”的英国小哥表示不想回家了！",
            "Cover": "http://mmbiz.qpic.cn/mmbiz_jpg/8vd2Hk2TS2Pfibh9ILZKicg5icBlWKHBIVibVM8Vupsg3NsfSnibzptB9XQxArqzFmfOw7nlk6ByTdNvWBoBf4NjVmQ/640?wxtype=jpeg&wxfrom=0",
            "Url": "http://mp.weixin.qq.com/s?__biz=MjM5MzI3NTI2MA==&mid=2651224106&idx=1&sn=0a5772013ae7c14dd9ac854f30fad934&chksm=bd6b54398a1cdd2f6f9c1d61c93aa3248968b8b56206a0af85341f510322b21548c975d8ebba&scene=0#rd"
        }],
        "Time": 1520732033,
        "NickName": "中国日报双语新闻"
    }],
    "ClickReportInterval": 600000
}

6、获取联系人列表

  • 说明：获取手机通讯录中的所有联系人（包括人、群、公众号等）
  • 请求方式：POST
  • 地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetcontact
  • get参数：
  • 参数示例值说明
    pass_ticketyp5RfCpb%2FsNVex0Uepn1BWXNCYCqTfqe8NOYzan%2B4Y4%3D公参中的值
    skey@crypt_8b4f09cc_1b827f84b1535b6be801f00427499050公参中的值
  • post参数： 
    {
    "BaseRequest": {均是公参中的值
        "Uin": 211722515,
        "Sid": "+FhlgkGS3wD/GKQw",
        "Skey": "@crypt_8b4f09cc_1b827f84b1535b6be801f00427499050",
        "DeviceID": "e609547902722302"
    }
}
  • 返回：所有通讯录中的联系人信息，主要在MemberList中查看 
    {
    "BaseResponse": {
        "Ret": 0,
        "ErrMsg": ""
    },
    "MemberCount": 771,
    "MemberList": [{
            "Uin": 0,
            "UserName": "@9c30c8d81e75a7eff0603cdd5de860b18fe92995845473fc2f0cda6ed76053cb",（微信随机码，潜规则：前面@为联系人，@@为群）
            "NickName": "Nandi Wardhana",（联系人的微信昵称）
            "HeadImgUrl": "/cgi-bin/mmwebwx-bin/webwxgeticon?seq=620986971&username=@9c30c8d81e75a7eff0603cdd5de860b18fe92995845473fc2f0cda6ed76053cb&skey=@crypt_8b4f09cc_1b827f84b1535b6be801f00427499050",
            "ContactFlag": 3,
            "MemberCount": 0,（如果是群，该字段表示成员数量）
            "MemberList": [],（群成员列表）
            "RemarkName": "",（备注名称，如果空则说明没有给他备注）
            "HideInputBarFlag": 0,
            "Sex": 1,（性别，1为男，2为女）
            "Signature": "Stay young naturally...",（签名）
            "VerifyFlag": 0,（用来判断是否是公众号或服务号的字段）
            "OwnerUin": 0,
            "PYInitial": "NANDIWARDHANA",
            "PYQuanPin": "NandiWardhana",（名字拼音全拼）
            "RemarkPYInitial": "",
            "RemarkPYQuanPin": "",
            "StarFriend": 0,
            "AppAccountFlag": 0,
            "Statues": 0,
            "AttrStatus": 2359303,
            "Province": "Jakarta Raya",（省份）
            "City": "",（城市）
            "Alias": "",
            "SnsFlag": 17,
            "UniFriend": 0,
            "DisplayName": "",（如果是群内成员，该字段表示群内名称）
            "ChatRoomId": 0,
            "KeyWord": "",
            "EncryChatRoomId": "",（如果是群，该字段表示群的id，不同于微信随机码@@那个）
            "IsOwner": 0
        },
        ... 此处省略剩下770个联系人信息
    ]
}

7、批量获取联系人详情

  • 说明：批量获取联系人详情，人或群均可。获取群详情主要是获取群内联系人列表。获取人详情主要是获取群内的某个人的详细信息。
  • 请求方式：POST
  • 地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxbatchgetcontact
  • get参数：
  • 参数示例值说明
    pass_ticketyp5RfCpb%2FsNVex0Uepn1BWXNCYCqTfqe8NOYzan%2B4Y4%3D公参中的值
    typeex我也不知道这是啥意思
  • post参数： 
    {
    "BaseRequest": {
        "Uin": 211722515,
        "Sid": "+FhlgkGS3wD/GKQw",
        "Skey": "@crypt_8b4f09cc_1b827f84b1535b6be801f00427499050",
        "DeviceID": "e862192966399662"
    },
    "Count": 2,
    "List": [{ 这里表示需要获取详情的所有联系人
            "UserName": "@@e203c90e07d64242336d573acd4a1db1c01ccb92ca05410444a3003c282c21db",
            "EncryChatRoomId": ""
        },
        {
            "UserName": "@ba194a63575be7fd0f4ea4e4547b2942d0dccc7fffc00ef5a6d141f93adb7739",
            "EncryChatRoomId": ""
        }
    ]
}
  • 返回： 
    {
    "BaseResponse": {
        "Ret": 0,
        "ErrMsg": ""
    },
    "Count": 2,
    "ContactList": [{
            "Uin": 0,
            "UserName": "@ba194a63575be7fd0f4ea4e4547b2942d0dccc7fffc00ef5a6d141f93adb7739",
            "NickName": "张三丰",
            "HeadImgUrl": "/cgi-bin/mmwebwx-bin/webwxgeticon?seq=680786093&username=@ba194a63575be7fd0f4ea4e4547b2942d0dccc7fffc00ef5a6d141f93adb7739&skey=",
            "ContactFlag": 3,
            "MemberCount": 0,
            "MemberList": [],
            "RemarkName": "丰哥",
            "HideInputBarFlag": 0,
            "Sex": 2,
            "Signature": "<span class=\"emoji emoji2600\"></span> 一定会找到<span class=\"emoji emoji1f31b\"></span>",
            "VerifyFlag": 0,
            "OwnerUin": 0,
            "PYInitial": "ZSF",
            "PYQuanPin": "zhangsanfeng",
            "RemarkPYInitial": "FG",
            "RemarkPYQuanPin": "fengge",
            "StarFriend": 0,
            "AppAccountFlag": 0,
            "Statues": 0,
            "AttrStatus": 111719,
            "Province": "北京",
            "City": "平谷",
            "Alias": "",
            "SnsFlag": 17,
            "UniFriend": 0,
            "DisplayName": "",
            "ChatRoomId": 0,
            "KeyWord": "",
            "EncryChatRoomId": "0",
            "IsOwner": 0
        }
        ...此处省略第二个联系人信息
    ]
}

8、消息检查

  • 说明：同步消息检查。这里只做检查不做同步，如果检查出有新消息，再掉具体同步的接口。
  • 请求方式：POST
  • 地址：https://webpush2.weixin.qq.com/cgi-bin/mmwebwx-bin/synccheck
  • get参数：
  • 参数示例值说明
    deviceide547171618594402参考5中的生成方式
    sid+FhlgkGS3wD/GKQw公参中的值
    skey@crypt_8b4f09cc_1b827f84b1535b6be801f00427499050公参中的值
    synckey1_700722177|2_700724323|3_700724315|1000_1520925834微信初始化后获取的4个key，这些key会随着每次获取最新消息（参见9）后的返回值更新，其目的在于每次同步消息后记录一个当前同步的状态。
    uin211722515公参中的值
  • 返回： 
    window.synccheck={retcode:"0",selector:"2"}
    retcode
    SUCCESS("0", "成功"),
    TICKET_ERROR("-14", "ticket错误"),
    PARAM_ERROR("1", "传入参数错误"),
    NOT_LOGIN_WARN("1100", "未登录提示"),
    NOT_LOGIN_CHECK("1101", "未检测到登录"),
    COOKIE_INVALID_ERROR("1102", "cookie值无效"),
    LOGIN_ENV_ERROR("1203", "当前登录环境异常，为了安全起见请不要在web端进行登录"),
    TOO_OFEN("1205", "操作频繁");
    selector
    NORMAL("0", "正常"),
    NEW_MSG("2", "有新消息"),
    MOD_CONTACT("4", "有人修改了自己的昵称或你修改了别人的备注"),
    ADD_OR_DEL_CONTACT("6", "存在删除或者新增的好友信息"),
    ENTER_OR_LEAVE_CHAT("7", "进入或离开聊天界面");

9、获取最新消息

  • 说明：当同步检查接口显示有新消息时，调用该接口获取具体的新消息。此处的新消息为广义的，包括消息，修改群名，群内成员变化，加好友等。
  • 请求方式：POST
  • 地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsync
  • get参数：
  • 参数示例值说明
    sid+FhlgkGS3wD/GKQw公参中的值
    skey@crypt_8b4f09cc_1b827f84b1535b6be801f00427499050公参中的值
    uin211722515公参中的值
  • post参数： 
    {
    "BaseRequest": {
        "Uin": 211722515,
        "Sid": "+FhlgkGS3wD/GKQw",
        "Skey": "@crypt_8b4f09cc_1b827f84b1535b6be801f00427499050",
        "DeviceID": "e304534670317808"
    },
    "SyncKey": {
        "Count": 4,
        "List": [{
            "Key": 1,
            "Val": 700722177
        }, {
            "Key": 2,
            "Val": 700724323
        }, {
            "Key": 3,
            "Val": 700724315
        }, {
            "Key": 1000,
            "Val": 1520925834
        }]
    },
    "rr": -508959981  String.valueOf(-new Date().getTime() / 1000)
}
  • 返回：主要有AddMsgList，ModContactList，DelContactList，新一轮消息同步的synckey 
    {
    "BaseResponse": {
        "Ret": 0,
        "ErrMsg": ""
    },
    "AddMsgCount": 1, 新增信息
    "AddMsgList": [{
        "MsgId": "320984672637990367", 服务端返回的消息id，可用于撤回接口参数。如果是图片，该参数还可以作为调用微信获取图片接口的参数之一。
        "FromUserName": "@abf90232027117affa7f0c0df3d1bf20", 发消息的人
        "ToUserName": "@abf90232027117affa7f0c0df3d1bf20", 发给谁
        "MsgType": 51, 消息类型，1为文字，3为图片...，具体请参照消息类型表
        "Content": "",
        "Status": 3,
        "ImgStatus": 1,
        "CreateTime": 1520927383,
        "VoiceLength": 0,
        "PlayLength": 0,
        "FileName": "",
        "FileSize": "",
        "MediaId": "",
        "Url": "",
        "AppMsgType": 0,
        "StatusNotifyCode": 4,
        "ForwardFlag": 0,
        "AppInfo": {
            "AppID": "",
            "Type": 0
        },
        "HasProductId": 0,
        "Ticket": "",
        "ImgHeight": 0,
        "ImgWidth": 0,
        "SubMsgType": 0,
        "NewMsgId": 320984672637990367,
        "OriContent": "",
        "EncryFileName": ""
    }],
    "ModContactCount": 0, 联系人修改
    "ModContactList": [],
    "DelContactCount": 0, 联系人删除
    "DelContactList": [],
    "ModChatRoomMemberCount": 0, 群内成员变动
    "ModChatRoomMemberList": [],"ContinueFlag": 0,
    "SyncKey": { 新一轮消息更新用这些SyncKey
        "Count": 7,
        "List": [{
            "Key": 1,
            "Val": 700722177
        }, {
            "Key": 2,
            "Val": 700724325
        }, {
            "Key": 3,
            "Val": 700724315
        }, {
            "Key": 11,
            "Val": 700724093
        }, {
            "Key": 201,
            "Val": 1520927383
        }, {
            "Key": 1000,
            "Val": 1520925834
        }, {
            "Key": 1001,
            "Val": 1520917874
        }]
    },
    "SKey": "",
    "SyncCheckKey": { 新一轮消息同步用这些Key
        "Count": 7,
        "List": [{
            "Key": 1,
            "Val": 700722177
        }, {
            "Key": 2,
            "Val": 700724325
        }, {
            "Key": 3,
            "Val": 700724315
        }, {
            "Key": 11,
            "Val": 700724093
        }, {
            "Key": 201,
            "Val": 1520927383
        }, {
            "Key": 1000,
            "Val": 1520925834
        }, {
            "Key": 1001,
            "Val": 1520917874
        }]
    }

}

10、创建群聊

略

11、修改群聊

略

12、发送消息

  • 说明：发送文本消息（包括表情），不能发送图片或文件。
  • 请求方式：POST
  • 地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsg
  • get参数：
  • 参数示例值说明
    pass_ticketyp5RfCpb%2FsNVex0Uepn1BWXNCYCqTfqe8NOYzan%2B4Y4%3D公参中的值
  • post参数： 
    {
    "BaseRequest": {
        "Uin": 211722515,
        "Sid": "+FhlgkGS3wD/GKQw",
        "Skey": "@crypt_8b4f09cc_1b827f84b1535b6be801f00427499050",
        "DeviceID": "e107694022625701"
    },
    "Msg": {
        "Type": 1,
        "Content": "呵呵",
        "FromUserName": "@abf90232027117affa7f0c0df3d1bf20",
        "ToUserName": "filehelper",
        "LocalID": "15209344559450477", 时间戳左移4位随后补上4位随机数
        "ClientMsgId": "15209344559450477"
    　　　　　"MediaId": "" 如果是图片才传这个值
    },
    "Scene": 0
}
  • 返回： 
    {
    "BaseResponse": {
        "Ret": 0,
        "ErrMsg": ""
    },
    "MsgID": "7615282929538795099", 服务端返回的消息id，可用于撤回等接口的参数
    "LocalID": "15209344559450477" 本地的消息id，是你自己发请求时的参数
}

13、上传文件到微信服务器

  • 说明：发送图片时需要先调用该接口将图片上传至微信服务器，微信会返回一个图片的id，发送消息时携带该id即可发送图片。
  • 请求方式：POST（此处的Content-Type应该设置为multipart/form-data; boundary=…------------------41184676334）
  • 地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxuploadmedia
  • get参数：
  • 参数示例值说明
    pass_ticketyp5RfCpb%2FsNVex0Uepn1BWXNCYCqTfqe8NOYzan%2B4Y4%3D公参中的值
  • post参数： 
    -----------------------------41184676334
Content-Disposition: form-data; name="id" 此处随意

WU_FILE_0
-----------------------------41184676334
Content-Disposition: form-data; name="name" 图片名称

Desert.jpg
-----------------------------41184676334
Content-Disposition: form-data; name="type" 图片类型

image/jpeg
-----------------------------41184676334
Content-Disposition: form-data; name="lastModifiedDate" 发送时间，该参数可无

Tue Jul 14 2009 13:32:31 GMT+0800
-----------------------------41184676334
Content-Disposition: form-data; name="size" 图片大小

845941
-----------------------------41184676334
Content-Disposition: form-data; name="chunks" 总共分多少批上传

2
-----------------------------41184676334
Content-Disposition: form-data; name="chunk" 当前是第几批

0
-----------------------------41184676334
Content-Disposition: form-data; name="mediatype" 当传图片时，此处写pic

pic
-----------------------------41184676334
Content-Disposition: form-data; name="uploadmediarequest"

      {
        "UploadType": 2, 固定为2
        "BaseRequest": {
          "Uin": 211722515,
          "Sid": "+FhlgkGS3wD/GKQw",
          "Skey": "@crypt_8b4f09cc_1b827f84b1535b6be801f00427499050",
          "DeviceID": "e787605163473377"
        },
        "ClientMediaId": 1520935168955,
        "TotalLen": 845941, 文件大小
        "StartPos": 0,
        "DataLen": 845941, 文件大小
        "MediaType": 4, 固定为4，表示图片
        "FromUserName": "@abf90232027117affa7f0c0df3d1bf20", 该参数可填可不填
        "ToUserName": "filehelper", 该参数可填可不填
        "FileMd5": "ba45c8f60456a672e003a875e469d0eb" 该参数随机一个uuid即可
      }

    -----------------------------41184676334
Content-Disposition: form-data; name="webwx_data_ticket"

gSenocajd7UaXQesCD3smJ5p
-----------------------------41184676334
Content-Disposition: form-data; name="pass_ticket"

yp5RfCpb/sNVex0Uepn1BWXNCYCqTfqe8NOYzan+4Y4=
-----------------------------41184676334
Content-Disposition: form-data; name="filename"; filename="Desert.jpg"
Content-Type: application/octet-stream

    此处为该文件的流，前端写成<input type="file">就是这个效果
  • 返回：可能分批次上传，最后上传成功时返回如下结果 
    {
    "BaseResponse": {
        "Ret": 0,
        "ErrMsg": ""
    },
    下面的MediaId参数，作为下一步发送图片接口的入参，就可以发送该图片了
    "MediaId": "@crypt_14402eb3_bb9eee20e7239fcd3323a0ea5a36cfd5e7fd162b72e03088efa4f63f53219c6f672c6be3ec1865291a70f38bb82bc5bf1d42166996b4a0313abe95454bff0316c19bfd29b71f4f98ccb7d301eed7b74995e35eabfd3f8264a3d684b8e9f08485ad00c3955cdc5b60ac96e67a9ca24bf7a01b9363ae0364f75fa0c9e6235e2dc91aef95b34c71c503deada9898a28ce5bf13d908f7834f7cae427aaba68aff5500125314f73b79f5a63103d430aa162420262e3d1a5e5f110cba0f2ee20017aaf0f127303153dcf63f9e5a56ff8c64f5dfb3f229011374b34fe7a905b0ee055d85b76827e2e68b8947c7b5fcd56c98ede9f012b6160a193762f63842886dca36872727db0c3cd4761af96c56bfdfb0a42630fee9954c764b5cd31f6ff666649b028bb1852366e639e1008cee678d5e587aabbe78014307ae1fbe638e2c0b52115",
    "StartPos": 845941,
    "CDNThumbImgHeight": 75,
    "CDNThumbImgWidth": 100,
    "EncryFileName": "Desert.jpg"
}

14、发送图片

  • 说明：上一步上传文件到微信服务器成功后，调用该发送图片接口。
  • 请求方式：POST
  • 地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsgimg
  • get参数：
  • 参数示例值说明
    pass_ticketyp5RfCpb%2FsNVex0Uepn1BWXNCYCqTfqe8NOYzan%2B4Y4%3D公参中的值
    funasync 
  • post参数：同发文本消息，只是多一个MediaId
  • 返回：同发文本消息

15、获取图片

  • 说明：上一步上传文件到微信服务器成功后，调用该发送图片接口。
  • 请求方式：GET
  • 地址：https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsgimg
  • get参数：
  • 参数示例值说明
    MsgID3176600141007621447服务端返回的消息id
    skey@crypt_8b4f09cc_1b827f84b1535b6be801f00427499050公参中的值 
    typeslave该参数有则为缩略图，没有则为原图
  • 携带3个cookie的值：wxuin，wxsid，webwx_data_ticket
  • 返回：图片的流

 

 二、一些状态码code值的说明

  1. BaseResponse里的Ret 
    SUCCESS("0", "成功"),
TICKET_ERROR("-14", "ticket错误"),
PARAM_ERROR("1", "传入参数错误"),
NOT_LOGIN_WARN("1100", "未登录提示"),
NOT_LOGIN_CHECK("1101", "未检测到登录"),
COOKIE_INVALID_ERROR("1102", "cookie值无效"),
LOGIN_ENV_ERROR("1203", "当前登录环境异常，为了安全起见请不要在web端进行登录"),
TOO_OFEN("1205", "操作频繁");
  2. 同步消息检查返回值中retcode和selector 
    retcode
  SUCCESS("0", "成功"),
  TICKET_ERROR("-14", "ticket错误"),
  PARAM_ERROR("1", "传入参数错误"),
  NOT_LOGIN_WARN("1100", "未登录提示"),
  NOT_LOGIN_CHECK("1101", "未检测到登录"),
  COOKIE_INVALID_ERROR("1102", "cookie值无效"),
  LOGIN_ENV_ERROR("1203", "当前登录环境异常，为了安全起见请不要在web端进行登录"),
  TOO_OFEN("1205", "操作频繁");
selector
  NORMAL("0", "正常"),
  NEW_MSG("2", "有新消息"),
  MOD_CONTACT("4", "有人修改了自己的昵称或你修改了别人的备注"),
  ADD_OR_DEL_CONTACT("6", "存在删除或者新增的好友信息"),
  ENTER_OR_LEAVE_CHAT("7", "进入或离开聊天界面");
  3. 消息类型 
    TEXT(1, "文本消息类型"),
IMAGE(3, "图片消息"),
VOICE(34, "语音消息"),
VIDEO(43, "小视频消息"),
MICRO_VIDEO(62, "短视频消息"),
EMOTI_CON(47, "表情消息"),
MEDIA(49, "多媒体消息"),
VOIP_MSG(50, ""),
VOIP_NOTIFY(52, ""),
VOIP_INVITE(53, ""),
LOCATION(48, ""),
STATUS_NOTIFY(51, "状态通知，自己访问了某一个聊天页面"),
SYS_NOTICE(9999, ""),
POSSIBLE_FRIEND_MSG(40, ""),
VERIFY_MSG(37, "好友请求"),
SHARE_CARD(42, "分享名片"),
SYS(10000, "系统消息"),
RECALLED(10002, "撤回消息");

转载于:https://www.cnblogs.com/flashsun/p/8493306.html

基于JS开发微信网页录音功能的实例代码
10-17
【微信网页录音功能详解】 微信网页录音功能是微信开发者工具提供的一种API，允许用户在微信内置浏览器中通过JavaScript实现语音录制并上传至服务器。这一功能对于实现互动性强、用户体验丰富的微信小程序或网页...
CURL 打印 POST请求信息
shenjianhua005的专栏
05-30 7045
由于项目需要给服务端发送请求信息，但那边总是格式不多，让服务端打印我的格式信息，总感觉挺麻烦的，后来自己查了资料，打印出来。参考官网：https://curl.haxx.se/libcurl/c/CURLOPT_DEBUGFUNCTION.html 比如我想发送的请求信息包含如下属性： POST /recognition HTTP/1.1 Host: www.xxx.xxx:8888 A...
vue axios form-data格式 传输数据和文件
block_xu的博客
09-09 8739
vue axios form-data格式 传输数据和文件 form-data在post请求下的一种传输方式，数据会在Form Data中传输，传输的数据由boundary来分割 ------WebKitFormBoundaryRO0YA4pq9oCgwTkt Content-Disposition: form-data; name="id" undefined ------WebKitFormBoundaryRO0YA4pq9oCgwTkt Content-Disposition: form-data;
微信网页登录接口实战
最新发布
qq_46292480的博客
08-23 1141
注册微信公众平台账号访问微信公众平台官网 (https://mp.weixin.qq.com)，注册并登录账号。创建一个新的公众号（如果已有公众号，则可直接使用），并获取AppID和AppSecret。配置公众号信息在公众平台管理后台，配置公众号的基本信息，包括网站地址等。配置“网页授权接口配置”，填写授权回调域名。
解决post请求form-data格式后端拿不到数据问题
NQ31
05-06 4836
在调用第三方后端接口的时候，有个接口，它要求post请求头中，content-type必须为multipart/form-data的时候，一开始就是显示指定content-type格式，也就是在请求头headers={‘Content-Type’: multipart/form-data}，导致form-data数据丢失，导致后端拿不到数据，一直报错。2、显示设置请求头，也就是上面出现bug的做法，但是需要做个格式。
HTTP请求POST、GET请求的数据格式(Content-type 和 Response-type)
热门推荐
yiyueqinghui的博客
07-29 2万+
在HTTP的请求头中，可以使用Content-type来指定不同格式的请求信息。 get方法： 　　在url中说明情请求的资源，比如https://www.baidu.com/com?from=self&name=xx 其中？后的数据就是请求的数据，并且连接用&，get方法也可以提交表单数据，但是提交的数据在url中，其他人可以通过查看历史记录中的url来获取你提交的数据，这样很不...
content disposition_聊一聊Content-Type
weixin_39890629的博客
11-28 601
Content-Type和POST结合用于前端请求Content-Type首字母即可大写也可小写Content-Type在headers对象中配置headersContent-Type设置与get请求无关,一般与post请求相关当用form表单提交时 Content-Type 默认为'application/x-www-form-urlencoded'。当用XHR提交时,Content-Type默...
微信支付 JS API支付接口详解
01-21
微信提供getBrandWCPayRequest接口供商户前端网页调用，调用之前微信会鉴定商户支付权限，若商户具有调起支付的权限，则将开始支付流程。这里主要介绍支付前的接口调用规则，支付状态消息通知机制请参加下文。接口...
微信网页第三方登录原理
01-27
微信网页第三方登录原理详解 微信网页第三方登录是微信开放平台提供的一种身份验证机制，它允许用户使用微信账号安全地登录第三方应用或网站。这一机制基于OAuth2.0协议，为开发者提供了一种便捷的方式来实现用户...
微信小程序详解
10-24
### 微信小程序详解 #### 一、微信小程序概述 微信小程序作为一种新兴的应用形式，自发布以来便受到了广泛的关注。它不仅改变了用户获取服务的方式，同时也为开发者提供了新的机遇与挑战。本文将从以下几个方面对...
微信小程序 解析网页内容详解及实例
12-12
之后，你可以将图片上传至云存储服务，如七牛云，再通过小程序接口下载并在小程序中展示，从而避免了直接解析和渲染表格的复杂性。 总的来说，通过将复杂的HTML内容，特别是表格，转换为图片，可以简化微信小程序中...
PHPCMS微信网页小游戏网站源码
03-10
2. **微信网页小游戏**：网页小游戏是指运行在浏览器环境中的小型游戏，无需下载安装，用户可以直接在微信内打开并游玩。通过集成微信的JSSDK（JavaScript SDK），开发者可以实现微信登录、分享、支付等与微信生态...
Net微信网页开发 使用微信JS-SDK获取当前地理位置过程详解
12-02
最后我想刚好做的是个微信网站项目，为什么不使用微信自带接口呢？所以最后使用了微信JS-SDK来获取用户当前地理位置的接口。 微信JS-SDK的使用步骤，配置信息的生成获取讲解： 关于JS-SDK的使用步骤和timestamp...
WeiXinEnterprisess.rar Java微信所有接口实现
05-12
Java微信企业号API实现详解 在Java开发中，微信企业号的应用越来越广泛，涉及到消息推送、用户管理、权限控制等多个方面。"WeiXinEnterprisess.rar" 是一个包含了Java调用微信企业号所有接口的代码实例，对于开发者...
微信网页版登陆原理
ZToDoList的博客
02-12 1556
微信网页版登陆原理 请求微信服务器返回一个会话ID 微信Web版本不使用用户名和密码登录，而是采用二维码登录，所以服务器需要首先分配一个唯一的会话ID，用来标识当前的一次登录，通过请求地址：
Vue知识点速查
抗争小青年的博客
06-21 1599
概述：Vue是一款前端渐进式框架，可以提高前端开发效率。特点：Vue通过MVVM模式,能够实现视图与模型的双向绑定。简单来说，就是数据变化的时候, 页面会自动刷新, 页面变化的时候，数据也会自动变化.Vue.js三种安装方式概述：Vue是一个类似于Jquery的一个JS框架，所以，如果想使用Vue，则在当前页面导入Vue.js文件即可。 语法： 案例： 2.内置指令 v-model表单绑定 实现双向绑定的本质：使用v-model的作用就是实现双向数据绑定1v-model可以使用时间和来进行替代。 ...
完整的微信登陆 接收消息流程
weixin_30421809的博客
02-20 1319
1. GET获取uuid = "YbnMBIWGuQ=="; https://login.weixin.qq.com/jslogin? appid=wx782c26e4c19acffb &redirect_uri=https%3A%2F%2Fwx.qq.com%2Fcgi-bin%2Fmmwebwx-bin%2Fwebwxnewloginpage &fun=new &amp...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值