目录

2. 主动触发接口(url直接请求发消息)


接口功能

软件自动开启WEB服务,可直接请求url地址(POST方式)发消息(好友/群)。(支持发文字,文章,图片,视屏,音乐,名片,文件,小程序)

与【开发版】的区别 ( 主动发消息 ):
开发版:被动方式,软件自定义周期性请求url,如果有返回值,则发消息。
web服务版:主动方式,任何人主动请求软件所在服务器url/ip,POST参数,则发消息。

【注意】
1. 软件修改端口,保存后未生效,请重启软件,再重新设置即可
2. POST请求直接传值 , utf-8格式 (如果出现乱码,建议检查代码文件编码,是否为utf-8,如果不是,请“另存为”选择编码“utf-8”即可)
3. 发消息格式:见发消息格式【POST参数例子】
    如: &rs=1&tip=这里是返回的内容,可以为空&wxid=wxid_12345678
4. 重要:返回的内容中,请勿有&符号

url地址

先在本软件中设置web服务器端口,请确保未被占用

url地址:即软件所在的服务器地址+端口

如:http://127.0.0.1:10248/

HTTP请求方式

POST

发消息PHP代码实例
//重要,文档保存时,先另存为(编码必须为 utf-8)
header("content-Type: text/html; charset=UTF-8"); //设置字符的编码是utf-8
$url = 'http://127.0.0.1:10248';
$post= '&rs=1&tip=这里是返回的内容,可以为空&wxid=5302111288@chatroom';
phppost($url, $post);
function phppost($remote_server, $post_string) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $remote_server);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $post_string);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    //curl_setopt($ch, CURLOPT_USERAGENT, "");
    $data = curl_exec($ch);
    curl_close($ch);
    return $data;
}
发消息格式 ( 严格按格式返回,非json )
返回参数 返回值 描述
rs 1 主动发消息(wxid为好友,chatroom为群)
POST参数例子(发好友) : &rs=1&tip=这里是返回的内容&wxid=wxid_12345678
POST参数例子(发群) : &rs=1&tip=这里是返回的内容&chatroom=12345678@chatroom
rs 10 获取指定群所有成员 (返回所有群成员参数 "memberlist",status=9退群,1正常)
POST参数例子 : &rs=10&chatroom=12345678@chatroom
rs 11 加群成员为好友
POST参数例子 : &rs=11&chatroom=12345678@chatroom&wxid=wxid_12345678
rs 12 发送进群邀请链接
POST参数例子 : &rs=12&chatroom=12345678@chatroom&wxid=wxid_12345678
rs 13 将当前发消息的群成员,踢出本群
POST参数例子 : &rs=13&chatroom=12345678@chatroom&wxid=wxid_12345678
rs 15 修改群名/好友备注
POST参数例子(改群名) : &rs=15&chatroom=12345678@chatroom&nickname=这里是新群的名字
POST参数例子(改好友备注) : &rs=15&wxid=wxid_12345678&nickname=这里是好友的备注
rs 15 获取好友与群列表数据 (与上面的区别: 不返回参数nickname即可)
POST参数: grouplist(群列表), friendlist(好友列表) .
注: 昵称可能带特殊符号,有可能导致json转换失败(不要直接转json),建议直接正则或循环取具体数据 (多测试)
POST参数例子 : &rs=15
rs 16 退出群 (wxid为要退的群)
POST参数例子 : &rs=16&tip=这里是返回的内容,可为空"&chatroom=12345678@chatroom
rs 20 关闭群触发
设置后,群内消息不再传至【触发接口】
POST参数例子 : rs=20&chatroom=12345678@chatroom
rs 21 开启群触发
设置后,群内消息传至【触发接口】
POST参数例子 : rs=21&chatroom=12345678@chatroom
rs 31 获取好友或群的名称 ( V1.14以上支持 )
unicode编码,需要解码
POST参数例子(取好友) : rs=31&wxid=wxid_12345678
POST参数例子(获取群) : rs=31&chatroom=12345678@chatroom

返回值格式说明(严格按格式返回,非json):

1. 返回多个消息, 可以自己组合:
{"&rs=1&tip=这里是返回的内容,utf-8格式中文,不需要转码[结束][img]http://www.dijiu.com/upload/2009/2/24/2009022479639361.gif[/img][结束][img]http://www.dijiu.com/upload/2009/2/24/2009022479639361.gif[/img]&wxid=wxid_12345678

可发送特殊格式:

1:网络图片:[结束][img]https://www.baidu.com/img/baidu_jgylogo3.gif[/img]

2:本地图片:[结束][localimg]D:\demo.jpg[/localimg]

3:发 文 章 :[结束][url][title=百度],[des=百度一下],[url=http://www.baidu.com/],[img=https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png][/url]

4:发小程序 :[结束][app][title=标题],[appnickname=小程序名称],[pagepath=小程序路径],[username=gh_xxxxxxx@app],[img=缩略图本地路径][/app]
【重要】必须pcwx2.7.1.82版及以上支持
小程序路径(可不填),具体内容在收到小程序后,软件日志中获取 <pagepath>小程序路径</pagepath>
gh_xxxxxxx@app(必填),具体内容在收到小程序后,软件日志中获取 <username>gh_xxxxxxx@app</username>

5:发 名 片 :[结束][card]好友微信号,好友昵称[/card]

6:发 视 频 :[结束][file]D:\demo.mp4[/file]

7:发 文 件 :[结束][file]本地文件路径[/file]

8:发 音 乐 :[结束][music][title=这里填写标题],[des=这里是描述],[url=这里是点击打开网址],[musicurl=这里是音频文件网址][/music]

9:@某人 :#@wxid_xxx# 内容@ (1.多个wxid用英文逗号; 2.[内容]中必须包含@, 只要@多少个成员, 内容中就必须包含多少个@符号,可以在任意位置)

10:发 公 告 :[notice]公告内容[/notice] (注: 机器人必须是群主)

11:图片+文字:这里是返回的内容[结束]这里是第二条消息[结束][img]https://www.baidu.com/logo.gif[/img][结束][img]https://www.baidu.com/logo.gif[/img][结束]分割

12:多条消息:用 [结束] 分割

13:随机消息:用 | 符号

14:随机代码:[随机表情] , [随机字母]