api地址:http://www.bbaos.com/docs/indexjavascript
第一步
开发者登陆
获取API token
POST
http://域名地址/foreign/auth/...
请求参数 Request Form Data Parameters
参数名 |
类型 |
说明 |
password必填 |
string |
开发者密码 |
phone必填 |
string |
开发者帐号 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
token |
string |
有效期交互密钥 |
-
注意:
java
- 参数格式是Form Data格式、非Json格式
- 此接口无需包装Headers信息
获取微信登陆二维码
获取二维码图片
POST
http://域名地址/foreign/messa...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
extend |
string |
用户自定义内容,回调时返回 |
account |
string |
微信号(微信第一次扫码不传,之后必须传,不然您可能会出现登陆设备已满,封号等状况) |
callback_url必填 |
string |
回调地址url(用于接收二维码、开发者需提供外网可访 访问的接口方法) |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
task_id |
int |
任务Id |
Callback_url回调参数
code |
int |
1成功,0失败 |
url |
string |
二维码图片(有可能须要转义) |
task_id |
int |
任务Id |
extend |
string |
自定义字段 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
自定义字段
{
"url": "https://xxxx/b0fdf40df44c3431601e59e988ee9f3.jpg",
"task_id": 40074,
"extend": ""
}
-
注意:
数据库
- 新微信号第一次调用此接口不传account,第二次至N次都要传account字段。
- 您编写的回调接口必定是Post方式且是表单
- 能够配置上下线回调地址获取扫码成功后的微信登陆信息,缓存至数据库,下次对比是不是第一次登陆
全局回调配置
配置全部微信回调通知
POST
http://域名地址/foreign/user/...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
callbackSend 必填 |
string |
通用接口 |
delfriendlog |
string |
删除好友回调接口地址 |
newfriendlog |
string |
添加好友通知(待赞成) |
messagelog |
string |
单聊消息接口 |
crowdlog |
string |
群聊消息接口 |
addfriendlog |
string |
已添加好友通知(会话列表通知) |
wacatout |
string |
接收微信状态接口地址(扫码成功后,会发送到此地址,上线,下线通知) |
addgrouplog |
string |
入群回调 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
帐户管理
退出微信
退出微信
POST
http://域名地址/foreign/wacat...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆微信号 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
查看微信在线状态
查看微信在线状态
POST
http://域名地址/foreign/messa...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆微信号 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
好友管理
添加好友
添加好友申请
POST
http://域名地址/foreign/frien...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
extend |
string |
自定义字段,通用回调--'加好友通知'原样返回 |
my_account必填 |
string |
登陆微信号 |
account必填 |
string |
微信号| 手机号(多个用英文状态下的逗号隔开) |
content必填 |
string |
验证消息 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
删除好友
删除好友申请
POST
http://域名地址/foreign/frien...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
extend |
string |
自定义字段,通用回调--'加好友通知'原样返回 |
my_account必填 |
string |
登陆微信号 |
to_account必填 |
string |
好友微信号 |
|
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
获取标签
获取标签
POST
http://域名地址/foreign/Wacat...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆微信号 |
tags 必填 |
string |
标签id 不传返回全部 |
|
建立标签
建立好友标签
POST
http://域名地址/foreign/Wacat...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆微信号 |
lables 必填 |
string |
标签名称 多个以英文 , 分割 |
|
callback_url 必填 |
string |
回调地址 |
|
callback_url 回调地址
lable_id |
int |
标签id |
account |
string |
微信号 |
lable_name |
string |
标签名称 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
{
"code": 1,
"info": [{
"lable_id": 6,
"account": "Forever4664666",
"lable_name": "你好"
}],
"msg": "建立成功"
}
修改标签
修改标签
POST
http://域名地址/foreign/Wacat...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
account必填 |
string |
多个 英文 , 逗号分隔 |
my_account必填 |
string |
登陆微信号 |
lable_id 必填 |
string |
多个 英文 , 逗号分隔 |
|
callback_url 必填 |
string |
回调地址 |
|
删除标签
删除标签
POST
http://域名地址/foreign/Wacat...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆微信号 |
lable_id |
string |
多个 英文 , 逗号分隔 |
|
callback_url 必填 |
string |
回调地址 |
|
检测僵尸粉
检测僵尸粉
POST
http://域名地址/foreign/Frien...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆微信号 |
account必填 |
string |
要检测的微信号 |
callback_url 必填 |
string |
回调地址 |
|
搜索微信号信息
搜索微信号信息
POST
http://域名地址/foreign/wacat...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
extend |
integer |
扩展字段 回调时原样返回 |
my_account必填 |
string |
登陆微信号 |
account必填 |
string |
好友微信号 |
好友待添加列表
好友待添加列表
POST
http://域名地址/foreign/frien...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆微信号 |
status必填 |
string |
-1:全部、 0:待验证、 1:已经过 、2:已过时 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
data |
array |
|
#### data解析小程序
字段名 |
类型 |
说明 |
id |
int |
ID |
my_account |
string |
登陆微信号 |
account |
string |
对方微信号 |
nickname |
string |
微信呢称 |
sign |
string |
签名 |
headHDImgUrl |
string |
微信头像地址 |
status |
int |
-1全部 0待验证 1已经过 2已过时 |
start_time |
int |
申请添加时间 |
check_msg |
string |
验证消息 |
source |
string |
来源 |
sourceNickname |
string |
推荐人昵称 |
sourceAccount |
string |
推荐人微信 |
sourceGroupNumber |
string |
来源群号 |
经过好友添加申请
经过好友添加申请
POST
http://域名地址/foreign/frien...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆微信号 |
account必填 |
string |
对方微信号 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
获取微信好友列表
获取微信好友列表
POST
http://域名地址/foreign/Frien...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆微信号 |
callback_url必填 |
string |
回调地址 |
回调字段释义
字段名 |
类型 |
说明 |
my_account |
string |
登陆的微信 |
currentPage |
string |
当前页码 |
info |
array |
信息 |
total |
int |
总数 |
info解析后数据
字段名 |
类型 |
说明 |
account |
string |
微信号 |
account_alias |
string |
微信ID |
name |
string |
昵称 |
sex |
int |
性别:0未知,1男,2女 |
area |
string |
地区 |
thumb |
string |
头像 |
description |
string |
描述 |
form_name |
string |
好友备注 |
disturb |
int |
是否免打扰:1是、2否 【接口为mac直接回调】3表示未开启免打扰,505表示开启免打扰 |
v1 |
string |
惟一数据 |
tag |
string |
标签 |
-
注意:
api
- 发送到回调接口的数据,每页100条推送到回调地址,直到全部好友推送完
获取微信号我的信息
获取微信信息
POST
http://域名地址/foreign/messa...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
微信号 |
返回字段释义:
字段名 |
类型 |
说明 |
account |
string |
微信号 |
account_alias |
string |
微信ID |
name |
string |
昵称 |
sex |
int |
性别:0未知,1男,2女 |
area |
string |
地区 |
decription |
string |
我的签名 |
thumb |
string |
头像 |
description |
string |
描述 |
is_online |
int |
在线状态(1:在线 2:离线) |
消息管理
发送普通消息
发送普通消息
POST
http://域名地址/foreign/messa...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
file_name |
string |
文件名称 |
my_account必填 |
string |
微信号 |
to_account必填 |
string |
好友微信号 |
微信群号 |
content必填 |
string |
内容 (语音、文件、图片都是连接地址) |
content_type必填 |
string |
1文本 |
2图片 |
4语音必须是silk文件,MP3的代码能够本身处理 |
5视频 |
6文件 |
15动图 |
type |
string |
1单聊,2群聊(默认1) |
img_md5 |
string |
动图必须图片的MD5 |
img_size |
string |
动图的文件大小 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
发送名片消息
发送名片消息
POST
http://域名地址/foreign/messa...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
微信号 |
to_account必填 |
string |
好友微信号 |
微信群号 |
card_name必填 |
string |
推荐人微信号/公众号微信号(支持我的名片、公众号名片) |
type |
string |
1单聊,2群聊(默认1) |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
发送URL连接
发送URL连接
POST
http://域名地址/foreign/messa...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
thumb |
string |
连接图片地址 |
describe |
string |
连接描述 |
my_account必填 |
string |
微信号 |
to_account必填 |
string |
好友微信号 |
微信群号 |
url必填 |
string |
连接地址 |
title必填 |
string |
连接标题 |
type |
string |
1单聊,2群聊(默认1) |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
发送小程序
发送URL连接、分享公众号、分享第三方文章等
POST
http://域名地址/foreign/messa...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
page_path |
string |
小程序跳转页面 |
app_name必填 |
string |
小程序的id (小程序相关参数如不清楚,能够发送小程序消息,经过消息回调获取到) |
title必填 |
string |
小程序名称 |
thumb_key必填 |
string |
小程序预览图密钥 |
my_account必填 |
string |
扫码登陆的微信号 |
to_account必填 |
string |
好友微信号 |
微信群号 |
describe |
string |
小程序描述 |
thumb_url |
string |
小程序预览图地址 |
type |
string |
1单聊,2群聊 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
群管理
设置群公告
设置群公告
POST
http://域名地址/foreign/Group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆微信号 |
number必填 |
string |
微信群号 |
notice 必填 |
string |
公告内容 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
建立微信群
建立微信群
POST
http://域名地址/foreign/group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
group_name必填 |
string |
建立群昵称 |
extend |
string |
扩充字段,可传入自定义数据 |
my_account必填 |
string |
登陆微信号 |
account必填 |
string |
微信号(多个用英文状态下的逗号隔开) |
callback_url |
string |
回调地址url |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
callback_url回调释义
data |
array |
返回数据 |
account |
string |
微信群号 |
extend |
string |
扩充字段 |
name |
string |
微信群名称 |
headerImage |
string |
微信群头像 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
data字段
"data": {
"account": "22156949594@chatroom",
"extend": " ",
"name": "历来处来从去处去",
"headerImage": "",
}
退出微信群
退出微信群
POST
http://域名地址/foreign/group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
g_number必填 |
string |
微信群群号 |
my_account必填 |
string |
微信号 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
修改群名称
修改群名称
POST
http://域名地址/foreign/group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
name必填 |
string |
微信群名称 |
my_account必填 |
string |
微信号 |
g_number必填 |
string |
微信群群号 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
邀请新成员
邀请新成员
POST
http://域名地址/foreign/group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
account必填 |
string |
微信群名称 |
my_account必填 |
string |
微信号 |
g_number必填 |
string |
微信群群号 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
踢出群成员
踢出群成员
POST
http://域名地址/foreign/group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
account必填 |
string |
群成员微信号 |
my_account必填 |
string |
微信号 |
g_number必填 |
string |
微信群群号 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
群聊@成员
群聊@成员
POST
http://域名地址/foreign/group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
account必填 |
string |
微信群号 |
my_account必填 |
string |
登陆微信号 (有wxid优先传wxid) |
atUser必填 |
string |
微信用户id(假如@多人,用英文逗号, 拼接) |
content必填 |
string |
'@'+成员的昵称+空格+内容 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
获取群二维码
获取群二维码
POST
http://域名地址/foreign/group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆微信号 |
g_number必填 |
string |
微信群群号 |
callback_url必填 |
string |
微信用户id(假如@多人,用英文逗号, 拼接) |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
data |
array |
一维数组 |
data含义
qrcode |
string |
群聊二维码 |
group_nickname |
string |
群聊别名 |
group_number |
string |
群号 |
headimg |
string |
群聊头像 |
owner |
string |
群主 |
type |
string |
类型 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
自动加入群聊
自动加入群聊
POST
http://域名地址/foreign/group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
account必填 |
string |
微信群号 |
status |
int |
0-关闭 1-开启 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
data |
JSON |
一维数组 |
获取群详细信息
获取群详细信息
POST
http://域名地址/foreign/group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
微信群号 |
g_number 必填 |
string |
群号 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
data |
arrary |
返回数据 |
data数听说明
参数名 |
类型 |
说明 |
name |
string |
群昵称 |
number |
string |
群号 |
thumb |
string |
群头像 |
disturb |
string |
是否免打扰 |
author |
string |
群主微信号或微信 |
data |
string |
群成员信息 |
获取微信群列表
获取微信群列表
POST
http://域名地址/foreign/group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
微信号 |
type 必填 |
int |
1全部群 2通信录的群 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
data |
arrary |
返回数据 |
page |
int |
总个数 |
total |
int |
反馈信息 |
data数听说明
参数名 |
类型 |
说明 |
number |
string |
群号 |
name |
string |
群昵称 |
thumb |
string |
群头像 |
disturb |
string |
是否免打扰 |
author |
string |
群主微信号或微信 |
获取微信群群主
获取微信群群主
POST
http://域名地址/foreign/group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆微信号 |
g_number 必填 |
string |
微信群群号 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
data |
arrary |
返回数据 |
author |
string |
群主微信号 |
获取微信群成员
获取微信群成员
POST
http://域名地址/foreign/Group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
number必填 |
string |
群号 |
my_account 必填 |
string |
扫码登陆的微信号 |
callback_url 必填 |
string |
回调地址 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
my_account |
string |
微信号wxID |
my_account_alias |
string |
微信号 |
info |
array |
二维数组 |
info解析
参数名 |
类型 |
说明 |
nickName |
string |
昵称 |
displayName |
string |
备注 |
bigHeadImgUrl |
string |
头像 |
userName |
string |
微信ID |
number |
string |
群号 |
发送群邀请连接
使用场景:群人员必须高于40人生效数组
发送群邀请连接 (需本人赞成方可入群)
POST
http://域名地址/foreign/group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
g_number必填 |
string |
群号 |
my_account 必填 |
string |
扫码登陆的微信号 |
account 必填 |
string |
要邀请的微信 【优先微信id】 |
自动加入群聊设置
自动加入群聊设置
若是自动加入群聊选项关闭,对于收到的入群邀请连接,能够自行决定要不要入群,要的话对这个url连接发post请求便可,这个url连接是通过咱们处理过的,处理前以下缓存
自动加入群聊设置
POST
http://域名地址/foreign/group...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
account必填 |
string |
微信号 |
status 必填 |
string |
自动加入群聊 0-关闭 1-开启 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
朋友圈
发送朋友圈
发送朋友圈
POST
http://域名地址/foreign/Frien...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆的微信号 |
text 必填 |
string |
发送朋友圈内容 |
media_url 必填 |
string |
图片url最多9张, 用{#}号分隔 | 视频{#}缩略图| 连接URL{#}缩略图,没有缩略图也要带上{#} |
media_type 必填 |
string |
1:图片 2:文字 3:视频 |
callback_url |
string |
回调地址url(接收结果) |
title |
string |
连接标题 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
朋友圈 -朋友圈点赞
朋友圈 -朋友圈点赞
POST
http://域名地址/foreign/Frien...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
my_account必填 |
string |
登陆的微信号 |
circle_id 必填 |
string |
朋友圈id |
content 必填 |
string |
评论内容 |
point_type 必填 |
string |
1-点赞 2-评论 |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
获取朋友圈列表
获取朋友圈列表
POST
http://域名地址/foreign/Frien...
Request Headers
Headers参数名 |
类型 |
说明 |
token必填 |
string |
有效期交互密钥 |
请求参数 Form Data Parameters
参数名 |
类型 |
说明 |
statusId |
string |
根据id获取指定朋友圈信息 |
extend |
string |
自定义拓展字段 回调时会原样返回 |
my_account必填 |
string |
登陆的微信号 |
to_account |
string |
查询指定微信号的我的相册 |
load 必填 |
integer |
评论内容 |
callback_url 必填 |
string |
获取列表数据回调的url |
返回说明
字段名 |
类型 |
说明 |
code |
int |
1成功,0失败 |
msg |
string |
反馈信息 |
data |
array |
callback_url 回调 二维数组 |
my_account |
string |
登陆的微信号 |
info |
string |
回调内容 |
profileImageURLString |
string |
微信用户头像 |
userString |
string |
微信号 |
mediaType |
string |
类别:1-图片 |
mediaObject |
string |
图片对象 |
imageURLStrings |
string |
朋友圈图片地址 |
nameString |
string |
昵称 |
statusId |
string |
朋友圈ID |
contentstring |
string |
朋友圈内容 |
createTime |
int |
建立时间 |
timeString |
int |
发表时间 |
回调说明
接收单聊天消息
接收单聊天消息 -当登陆微信号收到好友消息时,会给大家的接口发送数据
POST 须要你方提供接口地址(本身经过接口设置,接口说明在用户类菜单里)
示例
{
{
"data": {
"my_account": "damibtc",
"my_name": 12,
"to_account": "damibtc",
"to_name": 12,
"content": "556",
"content_type": 1,
"file_name": "",
"voice_len": 0,
"type": 1
}
}
}
参数名 |
类型 |
说明 |
my_account |
string |
登陆的微信号 |
my_name |
string |
个人微信昵称 |
to_account |
string |
好友的微信号 |
to_name |
string |
好友的微信昵称 |
content |
integer |
内容 |
content_type |
string |
int 1文字、2图片、3表情、4语音、5视频、6文件、7公众号名片、8url连接、9我的名片 10系统消息 11小程序 12 地图 13紅包 14转帐 15动图 |
file_name |
string |
文件名 |
voice_len |
string |
语音时长 |
type |
string |
类型:1登陆号发的、2好友发的 |
msgid |
string |
消息ID可用于区分是不是同一条消息 |
接收群聊天消息
当登陆微信号收到群消息时,会给大家的接口发送数据微信
接收群聊天消息
POST
示例
{
"data": {
"to_account": "damibtc",
"voice_len": 0,
"file_name": "",
"content_type": 1,
"to_name": "1266",
"my_account": "damibtc",
"g_name": "为了美好的明天而战888",
"g_number": "237576396656@chatroom",
"my_name": "1266",
"to_account_alias": "damibtc",
"content": "663"
}
}
参数名 |
类型 |
说明 |
my_account |
string |
登陆的微信号 |
my_name |
string |
个人微信昵称 |
to_account |
string |
好友的微信号 |
to_name |
string |
好友的微信昵称 |
content |
integer |
内容 |
content_type |
string |
int 1文字、2图片、3表情、4语音、5视频、6文件、7公众号名片、8url连接、9我的名片 10系统消息 11小程序 12 地图 13紅包 14转帐 15动图 |
file_name |
string |
文件名 |
voice_len |
string |
语音时长 |
type |
string |
类型:1登陆号发的、2好友发的 |
msgid |
string |
语音时长 |
msg_source |
string |
消息的额外信息 |
接收新增好友信息
须要你方提供接口地址(本身经过接口设置,接口说明在用户类菜单里)app
接收新增好友信息(添加成功后的回调)
POST
示例
{
"data": {
"uid": 2339,
"my_account": "damibtc",
"my_name": "1266",
"to_account": "66s",
"data": {
"name": "damibtc",
"sex": 1,
"area": "",
"thumb": "",
"type": 2,
"time": 1565861411,
"v1": ""
}
}
}
参数名 |
类型 |
说明 |
my_account |
string |
登陆的微信号 |
my_name |
string |
个人微信昵称 |
to_account |
string |
好友的微信号 |
data |
string |
好友信息 |
name |
integer |
好友昵称 |
account |
string |
好友微信号 |
sex |
int |
性别:0未知,1男,2女 |
area |
string |
地区 |
thumb |
string |
头像 |
type |
int |
请指定类型:1我加好友、2好友加我 |
接收微信退出、微信登陆消息
须要你方提供接口地址(本身经过接口设置,接口说明在用户类菜单里)post
接收微信退出、微信登陆消息
POST
示例
{
"data": [{
"type": "1",
"account": "damibtc",
"account_alias": "大米",
"name": "1266",
"task_id": 34100,
"thumb": "",
"extend": ""
}]
}
参数名 |
类型 |
说明 |
my_account |
string |
登陆的微信号 |
my_name |
string |
个人微信昵称 |
to_account |
string |
好友的微信号 |
data |
string |
好友信息 |
name |
integer |
好友昵称 |
account |
string |
好友微信号 |
sex |
int |
性别:0未知,1男,2女 |
area |
string |
地区 |
thumb |
string |
头像 |
type |
int |
请指定类型:1我加好友、2好友加我 |
接收有人加进群消息
须要你方提供接口地址(本身经过接口设置,接口说明在用户类菜单里)
当登陆微信全部群中有人加入其中一个群时,发出通知
POST
示例
{
"data": {
"g_number": "76655666@chatroom",
"account": "damibtc",
"name": "1266",
"my_account": "大米"
}
}
参数名 |
类型 |
说明 |
g_number |
string |
微信群号 |
account |
string |
好友微信号 |
name |
string |
微信号别名 |
my_account |
string |
微信号 |
接收新加好友信息(被加)
当登陆微信号有新的好友添加申请是发出幸亏有的信息**微信须要设置-->【我】→【设置】→【隐私】→开启按钮【加我为朋友时须要验证】
设置回调通知接口中提供的newfriendlog
POST
示例
{
'account' => 'damibtc',
'my_account' => '大米',
'account_alias' => 'wxid_95z5p9j8crbc22',
'encodeUserName' => 'v1_c8a3a6dabff12763e89bffd8cf81ff28dd185cc55150b7e36fa5ea38c0ac@stranger',
'nickname' => '一只猫',
'sex' => '0',
'country' => '',
'province' => '',
'city' => '',
'sign' => '',
'headHDImgUrl' => '',
'headImgUrl' => '',
'check_msg' => '我是一只猫',
'source' => '经过扫码添加',
'sourceNickname' => '',
'sourceAccount' => '',
'sourceGroupNumber' => '',
}
参数名 |
类型 |
说明 |
account |
string |
申请人的微信号 |
my_account |
string |
登陆的微信号 |
account_alias |
string |
申请人的微信ID |
encodeUserName |
string |
用户名 |
nickname |
string |
昵称 |
sex |
int |
性别:0未知,1男,2女 |
country |
string |
国家 |
province |
string |
省份 |
city |
string |
城市 |
sign |
string |
签名 |
headHDImgUrl |
string |
头像 |
headImgUrl |
string |
头像 |
check_msg |
string |
微信号 |
source |
string |
来源 |
sourceNickname |
string |
推荐人昵称 |
sourceAccount |
string |
推荐人微信 |
sourceGroupNumber |
string |
来源群 在群里申请时 |
接收新加好友信息(被加)
当登陆微信号有新的好友添加申请是发出幸亏有的信息**微信须要设置-->【我】→【设置】→【隐私】→开启按钮【加我为朋友时须要验证】
设置回调通知接口中提供的newfriendlog
POST
示例
{
'account' => 'damibtc',
'my_account' => '大米',
'account_alias' => 'wxid_9505p9j8crbc22',
'encodeUserName' => 'v1_c8a3a6dabff12763e89bffd8cf81ff28dd185cc55150b7e36fa5ea38c0ac@stranger',
'nickname' => '一只猫',
'sex' => '0',
'country' => '',
'province' => '',
'city' => '',
'sign' => '',
'headHDImgUrl' => '',
'headImgUrl' => '',
'check_msg' => '我是一只猫',
'source' => '经过扫码添加',
'sourceNickname' => '',
'sourceAccount' => '',
'sourceGroupNumber' => '',
}
参数名 |
类型 |
说明 |
account |
string |
申请人的微信号 |
my_account |
string |
登陆的微信号 |
account_alias |
string |
申请人的微信ID |
encodeUserName |
string |
用户名 |
nickname |
string |
昵称 |
sex |
int |
性别:0未知,1男,2女 |
country |
string |
国家 |
province |
string |
省份 |
city |
string |
城市 |
sign |
string |
签名 |
headHDImgUrl |
string |
头像 |
headImgUrl |
string |
头像 |
check_msg |
string |
微信号 |
source |
string |
来源 |
sourceNickname |
string |
推荐人昵称 |
sourceAccount |
string |
推荐人微信 |
sourceGroupNumber |
string |
来源群 在群里申请时 |
接收删除好友通知
当登陆微信号发起删除好友申请执行删除后,发出通知
须要你方提供接口地址(本身经过接口设置,接口说明在用户类菜单里)
POST
示例
{
"code": 0,
"msg": "删除成功",
"data": [{
"to_account": "damibtc",
"form_account": "azhi0hao"
}]
}
参数名 |
类型 |
说明 |
account |
string |
删除的微信号 |
my_account |
string |
登陆的微信号 |
接收查询微信好友信息
当登陆微信号收到好友消息时,会给大家的接口发送数据
须要你方提供接口地址(本身经过接口设置,接口说明在用户类菜单里)
POST
示例
{
"account": "damibtc",
"account_alias": "大米",
"area": "福建福州",
"extend": "这边是获取微信好友列表",
"header_url": "http://wx.qlogo.cn/mmhead/ver_1/XRc2e5njrM2v84vA9kr95fiaZVtmAynRicGsj475icKOXxoj3l22saiw2icsZ2xsfn5S6VXGJOXqOwWQTucKO3Lvny7TxFe3bAAvaUfWhVgC6XU/132",
"myAccount": "wxid_6mq1pu8n0j3r2",
"nickName": "Gu🦑",
"sex": 2,
"type": 2
}
参数名 |
类型 |
说明 |
type |
int |
2 表示回调的是查询的微信信息 |
account |
string |
微信号 |
account_alias |
string |
wxid |
area |
string |
地区 |
header_url |
string |
头像 |
myAccount |
string |
登陆的微信号 |
nickName |
string |
昵称 |
sex |
int |
性别 0未知 1男 2女 |
extend |
string |
扩展字段【自定义】 |
获取微信全部标签列表
当登陆微信号收到好友消息时,会给大家的接口发送数据
须要你方提供接口地址(本身经过接口设置,接口说明在用户类菜单里)
POST
示例
{
"account": "damibtc",
"account_alias": "大米",
"area": "福建福州",
"extend": "这边是获取微信好友列表",
"header_url": "http://wx.qlogo.cn/mmhead/ver_1/XRc2e5njrM2v84vA9kr95fiaZVtmAynRicGsj475icKOXxoj3l22saiw2icsZ2xsfn5S6VXGJOXqOwWQTucKO3Lvny7TxFe3bAAvaUfWhVgC6XU/132",
"myAccount": "wxid_6mq1pu8n0j3r2",
"nickName": "Gu🦑",
"sex": 2,
"type": 2
}
参数名 |
类型 |
说明 |
type |
int |
2 表示回调的是查询的微信信息 |
account |
string |
微信号 |
account_alias |
string |
wxid |
area |
string |
地区 |
header_url |
string |
头像 |
myAccount |
string |
登陆的微信号 |
nickName |
string |
昵称 |
sex |
int |
性别 0未知 1男 2女 |
extend |
string |
扩展字段【自定义】 |
用户手机点击扫码确认按钮的回调
须要你方提供接口地址(本身经过接口设置,接口说明在用户类菜单里)
返回微信扫码状态
POST
示例
{
"data": [{
"account": "damibtc",
"account_alias": "wxid_7mx5bzt1qz12",
"name": "大米",
"headimg": "http:\\/\\/wx.qlogo.cn\\/mmhead\\/ver_1\\/GL1FASadmu9AwAnhYXoq8Z3pAYYNh4M6CoZLu5cObjr31vaCib1nXPOacficFgYCQwagDaLKnNrooiaAdGoxUeGHLfTDz636tzSYZfjInhFo\\/0",
"status": 8,
"type": 4,
"app_token": "",
"extend": ""
}]
}
参数名 |
类型 |
说明 |
type |
int |
4 表示回调的是微信扫码状态 |
status |
int |
8用户已经点击确认按钮 |
account |
string |
微信号 |
account_alias |
string |
微信号(wxid) |
name |
string |
昵称 |
headimg |
string |
头像 |
extend |
string |
获取二维码时自定义参数 |
开发者微信
