架構

服務的技術規範。

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. 限制

即時處理

• 非同步批處理不適合即時場景
• 即時遊戲等需要即時處理的場景請考慮其他方案。

預期處理時間