# 云轩机器人管理平台

> 为飞书和 Telegram 机器人提供统一、签名鉴权的消息发送 API。支持应用内默认广播，以及按一个或多个机器人 ID、会话 ID 精确筛选。

## 生产入口

- 完整接口文档：https://bot.yunxuanwl.cn/docs/api-usage.md
- OpenAPI：https://bot.yunxuanwl.cn/docs/openapi.yaml
- SDK 下载：https://bot.yunxuanwl.cn/#downloads
- 公共 API：https://bot.yunxuanwl.cn/api/v1
- 管理后台：https://bot-ht.yunxuanwl.cn/admin/

## AI 接入顺序

1. 阅读完整接口文档，确认 AppID、AppKey、安全边界和签名规则。
2. 优先选择 Rust、Go、TypeScript 或 Dart SDK，不要重复实现签名。
3. 在管理后台配置应用允许使用的机器人与会话。
4. 不传目标筛选时为应用内广播；同时传机器人和会话条件时取交集。
5. 检查响应的 data.status 和 data.results；request_id 当前只用于追踪，不保证服务端幂等。

## 安全要求

- AppKey 只能保存于服务端环境变量或安全配置。
- 不得把生产 AppKey 写入网页、H5、Flutter 安装包、日志或 Git。
- 不要对结果不确定的发送请求自动重试。