可爱猫5.0插件雅爱HTTP_API说明

2020-09-15  阅读 290 次

雅爱HTTP_API 说明,这篇文章主要针对小白,雅爱HTTP_API功能基本完善,无限制,到目前为止支持可爱猫5.0构架里的所有功能。首先本人用PHP语言,其他不会,这里说下通过POST与可爱猫(5.0以上)功能交互过程,理论上其他语言也一样。希望对小白有帮助。

1、安装好插件后假如“客户”向机器人发送私聊文本消息如“帮助”那么机器人会返回调试日志如下图

雅爱笔记_www.5devip.com

打开“雅爱HTTP_API 私聊消息”可以看到一些信息,信息含义如下

雅爱笔记_www.5devip.com

leixing=100 消息类型 100私聊 200群聊 400入群 410退群 500好友请求
type=1 私聊或者群聊里的 1文本消息 3图片消息 34语音消息 42名片消息 43视频 47动态表情等
robot_wxid=wxid_123 当前登录的账号(机器人)id
from_wxid=wxid_789 对方id,就是你刚刚发送“帮助”消息微信号的id
from_name=Song 对方名称,就是你刚刚发送“帮助”消息微信号的名称
to_wxid=wxid_123 当前登录的账号(机器人)id
msg=帮助 发送的消息
to_name=乐之屋 当前登录的名称
msgid=1669823622 这个没有什么用 意思是唯一消息id
下面的json_msg数据就是上面的那些参数了。
“回调返回”是指你写的接口返回的数据(即面板里填的消息回调地址)如果你地址写错或者接口有问题了会返回网页404代码
json_msg={"content":"帮助","from_wxid":"wxid_789","from_name":"Song","final_from_wxid":"wxid_789","final_from_name":"Song","to_wxid":"wxid_123","to_name":"乐之屋","msgid":1669823622,"msg_type":1,"original_content":"E5B8AEE58AA9","send_out_type":-1,"timestamp":1600133082}  回调返回:ok

2、此时如果机器人接受到关键词“帮助”要返回一条消息给“客户”,那么你只需要post如下参数即可(表示发送了一条文本消息,内容为 欢迎加入雅爱社区!)

data={"type":1,"msg":"%E6%AC%A2%E8%BF%8E%E5%8A%A0%E5%85%A5%E9%9B%85%E7%88%B1%E7%A4%BE%E5%8C%BA%EF%BC%81","from_wxid":"wxid_789","robot_wxid":"wxid_123"}

其中参数名称为data值{"type":1,"msg":"%E6%AC%A2%E8%BF%8E%E5%8A%A0%E5%85%A5%E9%9B%85%E7%88%B1%E7%A4%BE%E5%8C%BA%EF%BC%81","from_wxid":"wxid_789","robot_wxid":"wxid_123"}

值是一个json数据,里面的参数与上面讲的一样,需要编码的参数有msg、from_name(只要可能会出现中文的都需要编码)如果这个你能实现,其他的基本一样都可以,多看下日志。

所有参数说明如下:

群聊消息
leixing=200
robot_wxid	机器人账号id(就是这条消息是哪个机器人的,因为可能登录多个机器人)
type	1/文本消息 3/图片消息 34/语音消息  42/名片消息  43/视频 47/动态表情 48/地理位置  49/分享链接  2001/红包  2002/小程序  2003/群邀请 更多请参考sdk模块常量值
from_wxid	来源群id
from_name	来源群昵称
final_from_wxid	具体发消息的群成员id
final_from_name	具体发消息的群成员昵称
to_wxid	接收消息的人id,(一般是机器人收到了,也有可能是机器人发出的消息,别人收到了,那就是别人)
to_name	接收消息的人昵称
msg	消息内容
msgid	消息唯一ID
json_msg	原始消息JSON集合,进阶开发者使用,版本要求 > 5.0
	
私聊消息
leixing=100
robot_wxid	机器人账号id(就是这条消息是哪个机器人的,因为可能登录多个机器人)
type	1/文本消息 3/图片消息 34/语音消息  42/名片消息  43/视频 47/动态表情 48/地理位置  49/分享链接  2001/红包  2002/小程序  2003/群邀请 
from_wxid	来源用户ID
from_name	来源用户昵称
to_wxid	接收消息的人ID(一般都是机器人收到了,所以这里是机器人ID,如果是机器人发出的,这里就是对方的ID)
to_name	接收消息的人昵称
msg	消息内容
msgid	消息唯一ID
json_msg	原始消息JSON集合,进阶开发者使用,版本要求 > 5.0

收到转账事件
leixing=700
robot_wxid	机器人账号ID(就是这条消息是哪个机器人的,因为可能登录多个机器人)
from_wxid	来源用户ID
from_name	来源用户昵称
to_wxid	接收消息的人ID(一般都是机器人收到了,所以这里是机器人ID,如果是机器人发出的,也就是接收转账,这里就是对方的ID)
money	金额
json_msg	收到转账的详细JSON信息,具体JSON结构请查看日志

面对面收款(二维码收款时,运行这里)
leixing=600
robot_wxid	收钱的人
pay_wxid	消息来源id
pay_name	消息来源昵称
money	金额
json_msg	更多详细的收款信息,具体JSON结构请查看日志

好友请求事件
leixing=500
robot_wxid	机器人账号id(这条消息是哪个机器人的,因为可能登录多个机器人)
from_wxid	陌生人用户id
from_name	陌生人用户昵称
to_wxid	忽略
json_msg	好友验证信息JSON对象(1/群内添加时,包含群id   2/名片推荐添加时,包含推荐人id及昵称  3/微信号、手机号搜索添加时),具体JSON结构请查看日志

群成员增加事件(新人进群)
leixing=400
robot_wxid	机器人账号id(就是这条消息是哪个机器人的,因为可能登录多个机器人)
from_wxid	来源群id
from_name	来源群名称
json_msg	新成员增加消息JSON对象,具体JSON结构请查看日志

群成员减少事件(群成员退出)
leixing=410
robot_wxid	机器人账号id(就是这条消息是哪个机器人的,因为可能登录多个机器人)
from_wxid	来源群id
from_name	来源群名称
json_msg	退出人的id|退出人的昵称

重要说明

1、最新可爱猫5.0 HTTP_API插件 雅爱HTTP_API5.0插件

   https://yaaibk.com/post/164.html

   可爱猫5.0插件雅爱HTTP_API说明

   https://yaaibk.com/post/166.html

2、插件授权过期的请下载QQ群里最新的插件,不行请换个微信号试一试。

3、插件返回的数据用post获取,根据自己用的语言用post获取全部数据比如PHP用$_POST即可获取插件返回的全部数据,其他语言post获取全部数据自己百度,我也不懂。(除了群聊和私聊返回的数据都用字段Data获取)

4、关于乱码,插件是易语言写的,易语言对字符串编码很是不友好,特别是特殊字符,基本上都是?????,PHP语言用我提供的例子只需要字符串是utf-8即可。其他语言发送消息时中文字符需要url编码且是utf-8,如果不行,换你的语言环境或库(如(JAVA)编码乱码可以 换个http请求库试下)

最新可爱猫5.0 HTTP_API插件 雅爱HTTP_API5.0插件

本文地址:https://yaaibk.com/post/166.html
版权声明:本文为原创文章,版权归 本站 所有,欢迎分享本文,转载请保留出处!

评论已关闭!