ForcePilot/backend/package/yuxi/channel/extensions/qqbot/api_routes.py
Kris 2ab65f153f feat(channel): 添加 QQ Bot 渠道扩展
新增 QQ Bot 渠道扩展,支持在 Yuxi 平台中集成 QQ 机器人渠道。

包含以下功能模块:
- api_client: QQ API 客户端封装
- api_routes: API 路由管理
- config: 渠道配置管理
- gateway: SSE/WebSocket 网关接入
- websocket: WebSocket 实时连接
- credentials: 凭证管理
- token: Token 管理
- outbound: 外发消息管理
- outbound_media: 媒体外发
- streaming: 流式消息处理
- streaming_media: 媒体流处理
- pairing: 用户配对与绑定
- security: 安全校验
- dedupe: 消息去重
- monitor: 渠道状态监控
- status: 会话状态管理
- session: 会话管理
- pipeline: 消息管道
- pipeline_stages: 管道阶段
- commands: 指令处理
- commands_builtin: 内置指令
- interaction: 交互处理
- approval: 审批流程
- ark: ARK 消息
- audio: 音频处理
- media: 媒体资源
- media_chunked: 分块媒体
- media_tags: 媒体标签
- message_queue: 消息队列
- delivery: 消息送达确认
- reconnect: 重连机制
- typing_keepalive: 输入状态保活
- group_activation: 群激活
- group_gating: 群门控
- group_history: 群历史
- known_users: 已知用户
- ref_index: 引用索引
- tools: Agent 工具集成
- types: 类型定义
2026-05-21 11:35:12 +08:00

107 lines
3.0 KiB
Python

from __future__ import annotations
API_BASE_URL = "https://api.sgroup.qq.com"
API_SANDBOX_URL = "https://sandbox.api.sgroup.qq.com"
TOKEN_URL = f"{API_BASE_URL}/app/getAppAccessToken"
GATEWAY_URL = f"{API_BASE_URL}/gateway"
GATEWAY_BOT_URL = f"{API_BASE_URL}/gateway/bot"
def c2c_messages_url(openid: str) -> str:
return f"{API_BASE_URL}/v2/users/{openid}/messages"
def c2c_stream_messages_url(openid: str) -> str:
return f"{API_BASE_URL}/v2/users/{openid}/stream_messages"
def c2c_files_url(openid: str, file_type: int = 1) -> str:
return f"{API_BASE_URL}/v2/users/{openid}/files"
def c2c_input_notify_url(openid: str) -> str:
return f"{API_BASE_URL}/v2/users/{openid}/input_notify"
def group_messages_url(group_openid: str) -> str:
return f"{API_BASE_URL}/v2/groups/{group_openid}/messages"
def group_files_url(group_openid: str, file_type: int = 1) -> str:
return f"{API_BASE_URL}/v2/groups/{group_openid}/files"
def channel_messages_url(channel_id: str) -> str:
return f"{API_BASE_URL}/channels/{channel_id}/messages"
def guilds_url() -> str:
return f"{API_BASE_URL}/users/@me/guilds"
def guild_channels_url(guild_id: str) -> str:
return f"{API_BASE_URL}/guilds/{guild_id}/channels"
def guild_members_url(guild_id: str) -> str:
return f"{API_BASE_URL}/guilds/{guild_id}/members"
def guild_announces_url(guild_id: str) -> str:
return f"{API_BASE_URL}/guilds/{guild_id}/announces"
def guild_schedules_url(guild_id: str) -> str:
return f"{API_BASE_URL}/guilds/{guild_id}/schedules"
def channel_forum_threads_url(channel_id: str) -> str:
return f"{API_BASE_URL}/channels/{channel_id}/threads"
def media_upload_url(openid: str, file_type: int) -> str:
return f"{API_BASE_URL}/v2/users/{openid}/files"
def group_media_upload_url(group_openid: str, file_type: int) -> str:
return f"{API_BASE_URL}/v2/groups/{group_openid}/files"
def resource_url(openid: str, file_type: int, url_type: int = 0, srv_send_msg: bool = False) -> str:
return f"{API_BASE_URL}/v2/users/{openid}/resource?file_type={file_type}&url_type={url_type}&srv_send_msg={'true' if srv_send_msg else 'false'}"
def c2c_message_url(openid: str, message_id: str) -> str:
return f"{API_BASE_URL}/v2/users/{openid}/messages/{message_id}"
def group_message_url(group_openid: str, message_id: str) -> str:
return f"{API_BASE_URL}/v2/groups/{group_openid}/messages/{message_id}"
def interaction_url(interaction_id: str) -> str:
return f"{API_BASE_URL}/interactions/{interaction_id}"
def dm_messages_url(guild_id: str) -> str:
return f"{API_BASE_URL}/dms/{guild_id}/messages"
def generate_url_link_url() -> str:
return f"{API_BASE_URL}/v2/generate_url_link"
def channel_message_url(channel_id: str, message_id: str) -> str:
return f"{API_BASE_URL}/channels/{channel_id}/messages/{message_id}"
def channel_url(channel_id: str) -> str:
return f"{API_BASE_URL}/channels/{channel_id}"
FILE_TYPE_IMAGE = 1
FILE_TYPE_VOICE = 3
FILE_TYPE_VIDEO = 2
FILE_TYPE_FILE = 4