雅爱HTTP_API 说明,这篇文章主要针对小白,雅爱HTTP_API功能基本完善,无限制,到目前为止支持可爱猫5.0构架里的所有功能。首先本人用PHP语言,其他不会,这里说下通过POST与可爱猫(5.0以上)功能交互过程,理论上其他语言也一样。希望对小白有帮助。
1、安装好插件后假如“客户”向机器人发送私聊文本消息如“帮助”那么机器人会返回调试日志如下图
打开“雅爱HTTP_API 私聊消息”可以看到一些信息,信息含义如下
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插件