获取二维码(第二步-方式1)
必看操作步骤!!!
⚠️1. 调用本接口得到二维码图片地址
⚠️2.调用执行登录接口(第三步)此时第三步接口不会立即返回,是根据用户是否扫码才返回数据,最长等待150S
⚠️3.开发者将本接口返回的二维码让用户去扫码
⚠️4.手机扫码结束后,手机不会显示ipad已登录,需要调用第三步接口方会显示登录成功!
⚠️5.方式1和2选择一种即可,本方式相比较方式2更安全稳定,但需要用户下载app/exe获取值并上传到接口达到双向交互,独家稳定安全,推荐使用本方式
请求URL:
●http://域名地址/localIPadLogin
请求方式:
●POST
请求头Headers:
●Content-Type:application/json
●Authorization:login接口返回
参数:
参数名 |
必选 |
类型 |
说明 |
wcId |
是 |
string |
登录的微信id (唯一id,用来寻找绑定设备,首次扫码传"",掉线后必须传值,否则每天都会创建新设备导致掉线!!!) 第三步接口 |
ttuid |
是 |
string |
ttuid是用户上传,用户需安装app/exe获取 若是开发者公司有app/exe也可直接集成sdk至app/exe中,无需下载我司提供的软件 |
返回数据:
参数名 |
类型 |
说明 |
code |
string |
1000成功,1001失败 |
msg |
string |
反馈信息 |
data |
||
wId |
string |
微信接口凭证ID (本值非固定的,每次重新登录会返回新的,数据库记得实时更新wid) |
qrCodeUrl |
string |
扫码登录地址 |
请求参数示例
JSON复制代码
{
"wcId": "wxid_wl9qchkanp9u22",
"ttuid": "fb24efa2-4c97-474a-8022-59f60820502c"
}
成功返回示例
JSON复制代码
{
"message": "登录成功",
"code": "1000",
"data": {
"wId": "0000016e-63ef-3a9c-0001-ed3311628ef4",
"qrCodeUrl": "http://127.0.0.1:18081/1573634652963-500000.png"
}
}
错误返回示例
JSON复制代码
{
"message": "用户名或密码错误",
"code": "1001",
"data": null
}
获取通讯录列表
●获取好友列表之前必须调用初始化通讯录列表接口。
●此接口不会返回好友/群的详细信息,如需获取详细信息,请调用获取联系人详情接口
●本接口的返回群聊的是保存到通讯录的群聊详细规范点击这里(第5大类3小节)
请求URL:
●http://域名地址/getAddressList
请求方式:
●POST
请求头Headers:
●Content-Type:application/json
●Authorization:login接口返回
参数:
参数名 |
必选 |
类型 |
说明 |
wId |
是 |
String |
微信实例标识 |
请求参数示例
{
"wId": "6a696578-16ea-4edc-ac8b-e609bca39c69"
}
成功返回示例
JSON复制代码
{
"code": "1000",
"message": "获取通讯录成功",
"data": {
"chatrooms": [
""
],
"friends": [
""
],
"ghs": [
""
],
"others": [
""
]
}
}
错误返回示例
{
"message": "失败",
"code": "1001",
"data": null
}
返回数据:
参数名 |
类型 |
说明 |
code |
String |
1000成功 1001失败 |
msg |
String |
反馈信息 |
data |
JSONObject |
|
chatrooms |
JSONArray |
|
friends |
JSONArray |
好友列表 |
ghs |
JSONArray |
公众号列表 |
others |
JSONArray |
微信其他相关 |
发送文本消息
请求URL:
●http://域名地址/sendText
请求方式:
●POST
请求头Headers:
●Content-Type:application/json
●Authorization:login接口返回
参数:
参数名 |
必选 |
类型 |
说明 |
wId |
是 |
string |
微信实例ID |
wcId |
是 |
string |
接收人微信号/群号 |
content |
是 |
string |
文本内容消息 |
返回数据:
参数名 |
类型 |
说明 |
code |
string |
1000成功,1001失败 |
msg |
string |
反馈信息 |
data |
||
data.type |
int |
类型 |
data.msgId |
long |
消息msgId |
data.newMsgId |
long |
消息newMsgId |
data.createTime |
long |
消息发送时间戳 |
data.wcId |
string |
消息接收方id |
请求参数示例
------------------------ 好友消息 ------------------------------
{
"wId": "0000016e-63eb-f319-0001-ed01076abf1f",
"wcId": "azhichao",
"content": "天行健,君子以自强不息"
}
成功返回示例
{
"code": "1000",
"message": "处理成功",
"data": {
"type": 1,
"msgId": 2562652205,
"newMsgId": 4482117376572170921,
"createTime": 1641457769,
"wcId": "azhichao"
}
}
错误返回示例
{
"message": "失败",
"code": "1001",
"data": null
}
添加好友
●本接口需在线3天后使用,且必须查看调用规范手册说明
简要描述:
●添加微信好友
请求URL:
●http://域名地址/addUser
请求方式:
●POST
请求头Headers:
●Content-Type:application/json
●Authorization:login接口返回
参数:
参数名 |
必选 |
类型 |
说明 |
wId |
是 |
string |
微信实例ID |
v1 |
是 |
string |
v1 |
v2 |
是 |
string |
v2 |
type |
是 |
int |
添加来源type值: |
verify |
是 |
String |
验证消息 |
返回数据:
参数名 |
类型 |
说明 |
code |
string |
1000成功,1001失败 |
msg |
string |
反馈信息 |
请求参数示例
{
"wId": "0000016f-a2f0-03e3-0003-65e826091614",
"v1": "v1_aaf94e13d0058cdc888e388b98952e0fc23212d180e4dacb38b96dfe4b078c488e72772f907517470ac0b9b7311826da@stranger",
"v2": "v2_13ced007472228cd1545feecf78b99f9a57a88843374513747afc7ac25d8a4cccb77590b7a9b01a96c941e047d137bbb@stranger",
"type": 3,
"verify": ""
}
成功返回示例
{
"message": "成功",
"code": "1000",
"data": null
}
错误返回示例
{
"message": "失败",
"code": "1001",
"data": null
}
扫码入群
好友将群二维码发送给机器人,机器人调用本接口将自动识别入群
请求URL:
●http://域名地址/scanJoinRoom
请求方式:
●POST
请求头Headers:
●Content-Type:application/json
●Authorization:login接口返回
参数:
参数名 |
必选 |
类型 |
说明 |
wId |
是 |
string |
微信实例ID |
url |
是 |
string |
群二维码url(二维码解析后的url) |
type |
否 |
int |
操作类型,默认0 |
返回数据:
参数名 |
类型 |
说明 |
code |
string |
1000成功,1001失败 |
msg |
string |
反馈信息 |
请求参数示例
JSON复制代码
{
"wId": "0000016f-a340-c2d7-0003-6ab83bc1e64a",
"url": "https://weixinxxx"
}
成功返回示例
{
"message": "成功",
"code": "1000",
"data": null
}
错误返回示例
{
"message": "失败",
"code": "1001",
"data": null
}
朋友圈点赞
请求URL:
●http://域名地址/snsPraise
请求方式:
●POST
请求头Headers:
●Content-Type:application/json
●Authorization:login接口返回
参数:
参数名 |
必选 |
类型 |
说明 |
wId |
是 |
String |
微信实例Id |
id |
是 |
String |
朋友圈Id |
请求参数示例
{
"wId": "0000016e-abcd-0ea8-0002-d8c2dfdb0bf3",
"id": "13205404970681503871"
}
成功返回示例
{
"message": "成功",
"code": "1000",
"data": null
}
错误返回示例
{
"message": "失败",
"code": "1001",
"data": null
}
创建视频号
●视频号创建成功后可手机查看
请求URL:
●http://域名/createFinder
请求方式:
●POST
请求头Headers:
●Content-Type:application/json
●Authorization:login接口返回
参数:
参数名 |
必选 |
类型 |
说明 |
wId |
是 |
String |
登录实例标识 |
nickName |
是 |
String |
视频号名称 |
headImgUrl |
是 |
String |
视频号头像 |
请求参数示例
JSON复制代码
{
"wId":"2c7a5bf6-e23d-x-8f03-b90e844b539f",
"nickName": "阿讯测试",
"headImgUrl": "https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fimg.jj20.com%2Fup%2Fallimg%2F1114%2F0G020114924%2F200G0114924-15-1200.jpg&refer=http%3A%2F%2Fimg.jj20.com&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=auto?sec=1657616129&t=f06cc1815b63173cca6f53a1f5e9f197"
}
成功返回示例
JSON复制代码
{
"message": "成功",
"code": "1000",
"data": null
}
错误返回示例
JSON复制代码
{
"message": "失败",
"code": "1001",
"data": null
}
返回数据:
参数名 |
类型 |
说明 |
code |
String |
1000成功 1001失败 |
msg |
String |
反馈信息 |
data |
JSONObject |
点赞
请求URL:
●http://域名/finderFav
请求方式:
●POST
请求头Headers:
●Content-Type:application/json
●Authorization:login接口返回
参数:
参数名 |
必选 |
类型 |
说明 |
wId |
是 |
String |
登录实例标识 |
id |
是 |
bigint |
视频号作品id |
nonceId |
是 |
String |
视频号作品nonceId |
type |
是 |
int |
操作类型 |
sessionBuffer |
是 |
String |
视频号作品的buffer信息 |
请求参数示例
JSON复制代码
{
"wId": "2c7a5bf6-e23d-x-8f03-b90e844b539f",
"id": 13826038549105019025,
"nonceId": "14864711500476047274_0_0_2_1",
"type": 1,
"sessionBuffer": "eyJzZXNzaW9uX2lkIjoic2lkXzIyMDc4OTQ2NjBfMTY1NzI5MzcwMTc0MDc0OF8yOTY2MTIxNjgiLCJjdXJfbGlrZV9jb3VudCI6NTIsImN1cl9jb21tZW50X2NvdW50IjoxOCwicmVjYWxsX3R5cGVzIjpbXSwiZGVsaXZlcnlfc2NlbmUiOjIsImRlbGl2ZXJ5X3RpbWUiOjE2NTcyOTM3MDEsInNldF9jb25kaXRpb25fZmxhZyI6OSwicmVjYWxsX2luZGV4IjpbXSwibWVkaWFfdHlwZSI6NCwidmlkX2xlbiI6MTA2MCwiY3JlYXRlX3RpbWUiOjE2NDgxOTIyMzIsInJlY2FsbF9pbmZvIjpbXSwic2VjcmV0ZV9kYXRhIjoiQmdBQXRyTzRGWlpKTUxuT2p1d2U5ZHFWcStMNDdpQjducm5IYkRmTzkybTV3V1FCMmRCKzg3N3lmM1wvWStUOWNvd3VXdUw1a3pnSWNpSXFwbDl2Rm1EZz0iLCJkZXZpY2VfdHlwZV9pZCI6MTMsImRldmljZV9wbGF0Zm9ybSI6ImlQYWQxMSwzIiwidmlkZW9faWQiOjEzODI2MDM4NTQ2MDY3MzU5OTAyLCJmZWVkX3BvcyI6MTIsImNsaWVudF9yZXBvcnRfYnVmZiI6IntcImlmX3NwbGl0X3NjcmVlbl9pcGFkXCI6MCxcImVudGVyU291cmNlSW5mb1wiOlwie1xcXCJmaW5kZXJ1c2VybmFtZVxcXCI6XFxcIlxcXCIsXFxcImZlZWRpZFxcXCI6XFxcIlxcXCJ9XCIsXCJleHRyYWluZm9cIjpcIlwiLFwic2Vzc2lvbklkXCI6XCIxNDNfMTY1NzI5MzY0MTI4MSMkMl8xNjU3MjkzNjMxNTk3I1wiLFwianVtcElkXCI6e1widHJhY2VpZFwiOlwiXCIsXCJzb3VyY2VpZFwiOlwiXCJ9fSIsIm9iamVjdF9pZCI6MTM4MjYwMzg1NDkxMDUwMTkwMjUsImZpbmRlcl91aW4iOjEzMTA0ODA0NzY4NDc3NTk1LCJjaXR5Ijoi5YyX5Lqs5biCIiwiZ2VvaGFzaCI6NDA2OTg4NTM3MjE1OTk3NCwicnFzdG0iOjE2NTcyOTM3MDEyMTgsInJzc3RtIjoxNjU3MjkzNzAxODkxLCJycWN0bSI6MzczMTI5MTYwOSwiZW50cmFuY2Vfc2NlbmUiOjEsImNhcmRfdHlwZSI6MSwiZXhwdF9mbGFnIjo1NzU5ODcsInVzZXJfbW9kZWxfZmxhZyI6OCwiY3R4X2lkIjoiMS0xLTIwLTAyNmIyOWM0YWYwZDhmZDg2NzdmYjlkNDVhNTNhNDM0MTY1NzI5MzcwMSJ9"
}
成功返回示例
JSON复制代码
{
"code": "1000",
"message": "视频号点赞成功",
"data": null
}
错误返回示例
JSON复制代码
{
"message": "失败",
"code": "1001",
"data": null
}
返回数据:
参数名 |
类型 |
说明 |
code |
String |
1000成功 1001失败 |
msg |
String |
反馈信息 |
data |
JSONObject |