i漂泊

 找回密码
 立即注册
搜索
热搜: 活动 交友 discuz
查看: 6198|回复: 0

[使用教程] 新版多QQ机器人-web接口之API接口

[复制链接]
TA的礼物信息
  • 收到:0
  • 送出:2
发表于 2016-7-18 15:40:01 | 显示全部楼层 |阅读模式
在版本的多QQ机器人WEB版中我们接入了API模块;(不过目前只有联系站长帮忙开通)


那么很多人就要问,API如何使用:
首先API目前仅支持2种模式:
1、被动接收:被动接收,就是你请求我们的API地址,告诉机器人该如何处理
2、主动推送:主动推送目前仅支持群聊,当QQ群有消息时,主动请求你的API地址,然后你输出要回复的内容,机器人自动按照的回复,发送到群;

被动接收接口写法:请求地址:http://www.51piaobo.com/piaobo_im.php?id=api 请将其中的www.51piaobo.com替换为你的网站地址
被动API入参
参数
是否必须
说明
key
申请的KEY
type
调用类型,qq wx 私聊或特定针对机器人时 qqqun wxqun 群聊或群事件
Event
事件,目前仅允许SendClusterMessage(推送QQ群消息),SendMessage(推送QQ好友消息)
robotid
申请接口时,所允许的QQ机器人号码
sendmsg
推送的消息内容,汉字编码必须为UTF-8
ExternalId
微信号,QQ号或者微信群号、QQ群号
md5hash
以上参数按照MD5HASH要求进行加密
返回:
  1. {
  2. "error": false,
  3. "code": 10
  4. }
复制代码
返回错误代码:
代码
说明
-1
接口KEY不存在
-2
KEY已经被停用
-3
接口项目不被允许
-4
接口类型不被允许
-5
接口类型与机器人类型不匹配
-6
ExternalId不在允许范围内
-7
secretkey与KEY不匹配
-8
事件类型不被允许
-9
入参丢失或变动,请核对后再试
-10
QQ好友不存在
-11
插入任务失败
-99
重参数缺失
>0
成功且返回任务ID
入参案例:
  1. $key = 'DW****1qB'; //你申请的KEY
  2. $param = array('key'=>$key,//密钥 必填
  3.     'Event' => $_GET['Event'], //事件类型 必填 'SendClusterMessage'=>群聊, 'SendMessage'=>私聊
  4.     'robotid' => $_GET['robotid'], //机器人ID 必填
  5.     'type' => $_GET['type'], //接口类型 必填 qq wx qqqun wxqun
  6.     'ExternalId' => $_GET['ExternalId'], //接收者 必填 QQ/QQ群 微信/微信群
  7.     'item' => 'passive', //默认值passive 必填
  8.     'sendmsg' => $_GET['Message']//发送消息 必填
  9. );
  10. $md5hashs = ApiMD5($key, $param);
  11. $url ='http://localhost/piaobo_im.php?id=api&md5hash='.$md5hashs['md5hash'].'&'.$md5hashs['params'];


  12. function ApiMD5($ApiKey, $param) {
  13.     ksort($param);
  14.     $params = '';
  15.     foreach ($param as $k => $v) {
  16.         $v = rawurldecode($v);
  17.         $params .= '&' . $k . '=' . rawurlencode($v);
  18.     }
  19.     $md5hash = md5(substr($params, 1) . $ApiKey);
  20.     return array('md5hash' => $md5hash, 'params' => substr($params, 1));
  21. }
复制代码






本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册

x
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

QQ|小黑屋|手机版|IPiaoBo Inc. ( 渝ICP备17002826号 )

GMT+8, 2024-3-28 23:47 , Processed in 0.070416 second(s), 51 queries .

Powered by Discuz! X3.4

Copyright © 2001-2020, Tencent Cloud.

快速回复 返回顶部 返回列表