企业微信协议最新版

获取二维码(第二步-方式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

群组列表 群组返回为null的处理方法(第5大类3小节)

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值:
3:微信号搜索
4:QQ好友
8:通过群聊
15:通过手机号

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
0: 进群
1:返回群名称及人数
10:返回原始html数据


返回数据:

参数名

类型

说明

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

操作类型
1:点赞
2:取消点赞

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

猜你喜欢

转载自blog.csdn.net/q2919761440/article/details/132071153