QQ机器人管理系统 API 参考手册
接口地址: /api/bot.php
参数: action=list
{"success": true, "data": [{"id": 1, "app_id": "xxx", "bot_username": "机器人名称"}]}
| 参数 | 说明 |
|---|---|
| action | login 必填 |
| app_id | 机器人AppID 必填 |
| app_secret | 机器人AppSecret 必填 |
| action | 说明 |
|---|---|
| refresh | 刷新Token (需app_id) |
| info | 获取机器人信息 (需app_id) |
| delete | 删除机器人 (需app_id) |
| update_secret | 修改密钥 (需app_id, new_app_secret) |
接口地址: /api/media.php
| 参数 | 说明 |
|---|---|
| action | upload 必填 |
| app_id | 机器人AppID 必填 |
| target_type | 目标类型 user/group 必填 |
| target_id | 目标ID 必填 |
| file_type | 1=图片 2=视频 3=语音 必填 |
| url | 资源URL 必填 |
| srv_send_msg | 是否直接发送 可选 |
{"success": true, "data": {"file_info": "xxx", "file_uuid": "xxx"}}
接口地址: /api/migrate.php
| action | 说明 |
|---|---|
| status | 获取迁移状态 |
| run | 执行单个迁移 (需version参数) |
| run_all | 执行所有待迁移 |
接口地址: /sp/api/query.php
| 参数 | 说明 |
|---|---|
| category | 分类名称 必填 |
| type | group/private 必填 |
示例: GET /sp/api/query.php?category=初见系列&type=group
{"success": true, "data": {"file_info": "xxx", "category": "初见系列", "use_count": 5}}
接口地址: /sp/api/config.php
参数: action=get_config
{"success": true, "data": {"bot_app_id": "xxx", "default_group_id": "xxx", "precache_count": "1"}}
| 参数 | 说明 |
|---|---|
| action | save_config 必填 |
| bot_app_id | 机器人AppID |
| default_group_id | 默认群ID |
| default_user_id | 默认好友ID |
| precache_count | 预缓存数量 |
| action | 说明 |
|---|---|
| sync_sources | 同步视频源文件 |
| get_categories | 获取所有分类 (GET) |
| get_stats | 获取缓存统计 (GET, 可选category参数) |
接口地址: /sp/api/upload.php
| action | 说明 |
|---|---|
| cache_next | 缓存下一个视频 (需category, type) |
| precache | 预缓存指定分类 (需category, 可选count) |
| precache_all | 预缓存所有分类 |
接口地址: /sp/api/refresh.php
| action | 说明 |
|---|---|
| refresh | 刷新即将过期的缓存 (默认) |
| precache | 预缓存所有分类 |
| sync | 同步视频源文件 |
| all | 执行全部任务 |
示例: GET /sp/api/refresh.php?action=all
# 每5分钟执行全部任务 */5 * * * * curl -s "http://your-domain/sp/api/refresh.php?action=all"
所有接口错误时返回:
{"success": false, "message": "错误描述"}