- API使用说明
- 1. 开发者HttpAPI接口原理:将所有参数,以POST方式,直接发送到开发者创建应用时的URL【接收地址】(开发者自己的URL地址),处理完数据按照指定格式,返回发送消息。
- 2. HttpApi接口完全免费,支持html(html必须支持post传参),php,asp,.net,jsp,cgi等所有web开发方式。
- 3. 关于管理地址,数据安全校验,系统自动在Url加上“chechk”参数(GET方式)
群应用算法 : chechk= md5('checkurl'.$_GET['gid'].$_GET['n'])
好友应用算法 : chechk=md5('checkurl'.$_GET['wxuin'].$_GET['n']) - 4. 特殊消息代码(需开通高级服务/开发者高级服务):
- 1)发图文:[结束][url][title=百度],[des=百度一下],[url=http://www.baidu.com/],[img=https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png][/url]
- 2)发图片:[结束][img]https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png[/img]
- 3)发名片:[结束][card]好友微信号,好友昵称[/card]
- 4)发视频:[结束][file]本地视频文件路径[/file]
- 5)发文件:[结束][file]本地文件路径[/file]
- 5)发音乐( 可直接播放,软件必须V3.31/3.42以上版本):[结束][music][title=这里填写标题],[des=这里是描述],[url=这里是点击打开网址],[musicurl=这里是音频文件网址][/music]
- 6)@某人:#@wxid_xxx#内容(1.多个wxid用英文逗号; 2.[内容]中必须包含@, @多少个成员, 内容中就必须包含多少个@符号,可以在任意位置, V3.31与开发版支持同时@多人)
- 7)发公告, [notice]内容[/notice] (机器人必须是群主)
- .. 【重要】应用创建成功后,在群里发“更新功能”,即可打通。(如何测试:在群里发“功能”,功能菜单出现创建的应用名称,说明打通成功。)
- 开发流程: 1.申请开发者->2.创建应用并绑定测试群->3.在绑定群直接使用 ( 如需上架,提交审核即可,上架的应用,必须有图文介绍,参考已上架应用)
- 应用创建后,无需提交审核,直接可以在绑定群/号进行测试,开发交流QQ群:512998803
- 平台提供:登录/注册/同步接口,有需要合作的软件请联系客服QQ:1756292969
- 【小翼开发版 - 稳定版 2.0】: 立即下载(无任何多余功能,更稳定)
- 【小翼开发版 - 最新版 3.0】: 立即下载(无任何多余功能,更稳定) | 新版接口文档 >>
应用接口-HttpAPI (稳定版 2.0 开发文档) |
1. [群] 关键词触发(创建应用时,触发关键词留空,则所有消息都触发)
【接收地址】收到参数 | 名称 | 描述 |
---|---|---|
robotid | 机器人唯一 ID | 扫码机器人的唯一 ID |
msgid | 消息 ID | |
gid | 群唯一 ID | |
gusername | 群唯一ID | |
gname | 群名称 | 已经转码为:Unicode编码,格式”\u“,需要在服务器解码 |
mid | 群成员唯一 ID | |
nickname | 群成员 昵称 | 已经转码为:Unicode编码,格式”\u“,需要在服务器解码 |
displayname | 群成员 名片 | 已经转码为:Unicode编码,格式”\u“,需要在服务器解码 | gadmin | 群管理员 | 唯一id,多个以逗号隔开 |
skw | 应用 ID | 创建应用的唯一 ID |
content | 消息内容 | 用户消息触发,带参数时,使用该字段。 已经转码为:Unicode编码,格式”\u“,需要在服务器解码 |
atlist | @多个用户 | 用户消息@其他用户时,触发。 可能含多个用户ID |
robotnickname | 机器人昵称 | 用户消息触发,带参数时,使用该字段。 已经转码为:Unicode编码,格式”\u“,需要在服务器解码 |
atmod | @模式开启状态 | 1开启,0关闭 (软件上是否开启了: 群聊@模式) |
URL返回值格式(严格按格式返回,非json):
注:格式二,小翼版3.16及以上版本支持
格式一,普通回复(直接回复发消息对象):{"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]","end":0}
格式二,扩展回复(直接回复发消息对象,扩展另增加指定对象):{"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]","wxuin":"扩展对象","wxuin_tip":"扩展回复内容","end":0}
格式三,特殊处理(见下表):
返回参数 | 返回值 | 描述 |
---|---|---|
rs | 1 | 正常触发消息 |
rs | 10 | 获取当前群所有成员,软件会再调一次接口 (发送所有群成员参数"memberlist",status=9退群,1正常),不会处理返回值 返回例子 : {"rs":10,"tip":"这里是返回的内容","end":0} |
rs | 13 | 正常触发消息,并将当前发消息的群成员,踢出本群 返回例子 : {"rs":13,"tip":"这里是返回的内容,xxx你被踢了","end":0} |
rs | 14 | 正常触发消息,并将返回的群成员昵称/wxid,踢出本群。返回多个昵称用[结束]分割。 ( 附加参数:"nickname") 返回例子 : {"rs":14,"tip":"这里是返回的内容","nickname":"香蕉[结束]茄子[结束]草莓","end":0} |
注:支持文字、图片、多条消息。
1:图片格式(jpg,gif,png):[结束][img]https://www.baidu.com/logo.gif[/img][结束]
2:多条消息:用[结束]分割
3:若有图片与文字,图片必须为单独的消息,如:这里是返回的内容[结束]这里是第二条消息[结束][img]https://www.baidu.com/logo.gif[/img][结束][img]https://www.baidu.com/logo.gif[/img]
2. [群] 主动消息接口 ([群]定时消息)
【接收地址】收到参数 | 名称 | 描述 |
---|---|---|
robotid | 机器人唯一 ID | |
gid | 群唯一 ID | |
skw | 应用 ID | 创建应用的唯一 ID |
URL返回值格式(严格按格式返回,非json):{"rs":1,"tip":"消息的内容","end":1}
注:支持文字、图片、消息分割、emoji。
1:图片格式(jpg,gif,png):[img]https://www.baidu.com/logo.gif[/img]
2:多条消息:用[结束]分割
3:若有图片与文字,图片前必须加[结束],如:这里是返回的内容[结束]这里是第二条消息[结束][img]https://www.baidu.com/logo.gif[/img][结束][img]https://www.baidu.com/logo.gif[/img]
4:V2.1以上版本支持该接口。
5:【接口逻辑】系统每隔一定周期,自动请求接口一次。返回的消息,必须为(当前时间+10秒以上)才会发送。具体触发定时,以软件所在电脑时间为准。
(1) 一般:2分钟周期
6:由于系统会周期性请求新的数据,所以,每次返回单条定时消息即可。
3. [友] 好友聊天关键词触发
【接收地址】收到参数 | 名称 | 描述 |
---|---|---|
msgid | 消息 ID | |
robotid | 机器人唯一 ID | |
mid | 好友ID | 唯一 | username | 群成员 |
nickname | 好友昵称 | 已经转码为:Unicode编码,格式”\u“,需要在服务器解码 |
content | 消息内容 | 已经转码为:Unicode编码,格式”\u“,需要在服务器解码 | robotnickname | 机器人昵称 | 用户消息触发,带参数时,使用该字段。 已经转码为:Unicode编码,格式”\u“,需要在服务器解码 |
URL返回值格式(严格按格式返回,非json):{"rs":1,"tip":"么么哒(づ 3 )づ[结束][img]http://www.dijiu.com/upload/2009/2/24/2009022479639361.gif[/img][结束][img]http://www.dijiu.com/upload/2009/2/24/2009022479639361.gif[/img]","end":0}
返回参数 | 返回值 | 描述 |
---|---|---|
rs | 1 | 正常触发消息 返回例子 : {"rs":1,"tip":"你好,这里是返回的内容","end":0} |
rs | 12 | 返回群的关键词,第一个匹配成功的群(默认模糊匹配,支持正则),系统自动邀请聊天好友加入 返回例子 : {"rs":12,"tip":"你好,已经邀请你加入群聊咯","gname":"测试1","end":0} |
注:支持文字、图片、多条消息。
1:图片格式(jpg,gif,png):[img]https://www.baidu.com/logo.gif[/img]
2:多条消息:用[结束]分割
3:若有图片与文字,图片必须为单独的消息,如:这里是返回的内容[结束]这里是第二条消息[结束][img]https://www.baidu.com/logo.gif[/img][结束][img]https://www.baidu.com/logo.gif[/img]
4:这里设置后,若群内使用该功能,则将动态显示在”功能菜单“中
5:转账消息格式, 请自行分析收到代码 (消息类型: msgtype=49 收到转账 , 其他自己测试)
4. [友/群] 主动消息接口(任意) ([友/群]定时消息) ( V3.31 或 开发版 支持)
【接收地址】收到参数 | 名称 | 描述 |
---|---|---|
robotid | 机器人唯一 ID | |
robotnickname | 机器人昵称 | |
skw | 应用 ID | 创建应用的唯一 ID |
URL返回值格式(严格按格式返回,非json):
返回参数 | 返回值 | 描述 |
---|---|---|
rs | 1 | 正常触发消息 返回例子 : {"rs":1,"wxid":"发送对象支持任意好友,任意群(友:wxid_xxxxxx,群:xxxx@chatroom)","tip":"消息的内容","end":1} |
rs | 15 | 返回当前机器人好友/群列表, 以POST方式传给接收地址. POST参数: grouplist(群列表), friendlist(好友列表) . 注: 昵称带特殊符号,有可能导致json转换失败(不要直接转json),建议直接正则或循环取具体数据 (多测试) 返回例子 : {"rs":15,"end":1} |
注:支持文字、图片、消息分割、emoji。
1:图片格式(jpg,gif,png):[img]https://www.baidu.com/logo.gif[/img]
2:多条消息:用[结束]分割
3:若有图片与文字,图片前必须加[结束],如:这里是返回的内容[结束]这里是第二条消息[结束][img]https://www.baidu.com/logo.gif[/img][结束][img]https://www.baidu.com/logo.gif[/img]
4:V3.29以上版本支持该接口
5:【接口逻辑】系统每隔一定周期,自动请求接口一次。返回的消息,建议为(当前时间+10秒以上)。具体触发定时,以软件所在电脑时间为准。
(1) 周期:120秒周期(稳定版),60秒(内测版)
6:由于系统会周期性请求新的数据,所以,每次返回单条定时消息即可。
7:【重要】本接口创建应用后,需要点击软件上【更新功能】