架构

服务的技术规范。

1. 性能

快速响应

• API 调用经过验证后加入队列，实现快速响应
• 数据存储和 Webhook 调用异步处理

自动扩展

• 后端随流量自动扩展
• 高负载下响应时间依然快速

速率限制

• 无每秒限制（除非遭受攻击）
• 在月度配额内自由使用

2. 安全性

攻击防护

• DDoS 攻击自动检测和拦截
• 恶意流量在到达服务前被过滤

加密

• 所有 API 通信通过 HTTPS/TLS 加密

3. 数据

支持的格式

• 可存储任何标准 JSON 数据
• 支持嵌套对象和数组

大小限制

• 每次请求最大 100KB

脚本防护

• JSON 数据按原样存储，绝不执行
• Webhook 原样转发数据
• 消费端应用应适当转义数据

4. 可靠性

数据丢失防护

• 队列优先设计：请求先加入队列再处理，即使数据库故障也不会丢失数据
• 3级自动恢复：应用层重试 → 队列重试（5分钟间隔，约8小时）→ 死信队列恢复（30分钟间隔，约48小时）
• 总自动恢复覆盖时间约56小时

备份

• 数据库每日备份
• 保留最近7天的备份

错误处理责任

• 一旦 API 返回 202 Accepted，数据处理由系统保证
• 如果 API 网关不可达（5xx），调用方应实现指数退避重试逻辑

5. 限制

实时处理

• 异步批处理不适合实时场景
• 实时游戏等需要即时处理的场景请考虑其他方案。

预期处理时间