|
在版本的多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要求进行加密 | 返回:
- {
- "error": false,
- "code": 10
- }
复制代码 返回错误代码:
代码 | 说明 | -1 | 接口KEY不存在 | -2 | KEY已经被停用 | -3 | 接口项目不被允许 | -4 | 接口类型不被允许 | -5 | 接口类型与机器人类型不匹配 | -6 | ExternalId不在允许范围内 | -7 | secretkey与KEY不匹配 | -8 | 事件类型不被允许 | -9 | 入参丢失或变动,请核对后再试 | -10 | QQ好友不存在 | -11 | 插入任务失败 | -99 | 重参数缺失 | >0 | 成功且返回任务ID | 入参案例:- $key = 'DW****1qB'; //你申请的KEY
- $param = array('key'=>$key,//密钥 必填
- 'Event' => $_GET['Event'], //事件类型 必填 'SendClusterMessage'=>群聊, 'SendMessage'=>私聊
- 'robotid' => $_GET['robotid'], //机器人ID 必填
- 'type' => $_GET['type'], //接口类型 必填 qq wx qqqun wxqun
- 'ExternalId' => $_GET['ExternalId'], //接收者 必填 QQ/QQ群 微信/微信群
- 'item' => 'passive', //默认值passive 必填
- 'sendmsg' => $_GET['Message']//发送消息 必填
- );
- $md5hashs = ApiMD5($key, $param);
- $url ='http://localhost/piaobo_im.php?id=api&md5hash='.$md5hashs['md5hash'].'&'.$md5hashs['params'];
- function ApiMD5($ApiKey, $param) {
- ksort($param);
- $params = '';
- foreach ($param as $k => $v) {
- $v = rawurldecode($v);
- $params .= '&' . $k . '=' . rawurlencode($v);
- }
- $md5hash = md5(substr($params, 1) . $ApiKey);
- return array('md5hash' => $md5hash, 'params' => substr($params, 1));
- }
复制代码
|
本帖子中包含更多资源
您需要 登录 才可以下载或查看,没有帐号?立即注册
x
|