🔗 TG 账号管理 · 对接网关
Cloudflare Pages 部署 · API Key 由服务端注入,调用方无需持有源站 Key
怎么用(外部项目对接统一走本网关):
curl -X POST https://<你的>.pages.dev/api/accounts/list \
-H "Content-Type: application/json" \
-H "X-Gateway-Token: ***" \
-d '{}'
· 真实 API Key 保存在 Cloudflare 环境变量 TG_API_KEY 中,不进代码、不下发给调用方
· 若部署时配置了 GATEWAY_TOKEN,每个请求需携带 X-Gateway-Token(或 Authorization: Bearer …)
· 网关只放行 /api/accounts/*;群管理等接口无法通过
📡 可用接口
| 接口 | 说明 |
POST /api/accounts/list | 账号列表与在线状态 |
POST /api/accounts/sendcode · login · logout · reload | 登录 / 生命周期 |
POST /api/accounts/sysmsg | 系统消息(含登录验证码) |
POST /api/accounts/chat/{dialogs,messages,send} | 会话列表 / 消息收发 |
POST /api/accounts/{add,save,delete} · settings/* | 账号管理 / 资料设置 |
🧪 在线测试
🔒 安全建议
1. TG_API_KEY 与 GATEWAY_TOKEN 都设为 Secret 类型环境变量,并定期在面板轮换 API Key
2. 建议开启 GATEWAY_TOKEN,避免 pages.dev 地址被扫描滥用
3. 高级防护可在 Cloudflare 开启 Access 或 WAF 规则限制来源