USP API Gateway

十月飛雲｜Shi Yue Fei Yun · 統一微服務進站閘道
● 檢測中... OpenAPI 規範
Unified Service Platform v3.2

高可用 · 零信任 · 反向代理閘道

作為十月飛雲全微服務體系之唯一單一進入點 (Single Point of Ingress)，整合進站流量過濾、WAF 威脅攔截、UIP 無密碼身分洗滌、多維度漏桶限流、防重放攻擊防禦與 SHA-256 不可篡改稽核存證。

瀏覽微服務路由矩陣 開發者接入協議
16
註冊微服務子網域
0 Password
全站純 OAuth 2.0 / UIP 認證
±300s
防重放容錯視窗 (X-Timestamp)
100% Trace
全域分散式呼叫鏈 (X-Request-ID)

微服務動態路由矩陣 (Routing Matrix)

客戶端統一呼叫 https://gateway.twots.top/api/v1/{service}/*，閘道自動完成鑑權清洗並轉發至下游內部子網域。

統一身分認證中心 公開

無密碼 OAuth 2.0 (Google/Discord/LINE) 與 TOTP/WebAuthn MFA

轉發前綴: /api/v1/uip

目標: auth.twots.top
平台註冊中心 公開

服務目錄、資產治理、安全政策與非公開架構文件託管

轉發前綴: /api/v1/registry

目標: registry.twots.top
API 閘道服務 需認證

流量路由、WAF、限流、防重放與熔斷器保護

轉發前綴: /api/v1/gateway

目標: gateway.twots.top
第三方整合服務 需認證

外部金流 Webhook、第三方平台 API 對接與非同步佇列

轉發前綴: /api/v1/integration

目標: integration.twots.top
支付與金流服務 需認證

金流代收、發票開立、對帳管理，強制 MFA 與嚴格防重放

轉發前綴: /api/v1/payment

目標: payment.twots.top 強制 MFA
統一通知服務 需認證

Email (SMTP) 與 Discord Webhook 渠道，全平台嚴禁 SMS

轉發前綴: /api/v1/notify

目標: notify.twots.top
商品與庫存服務 需認證

數位商品、授權金鑰發放與高併發扣減保護

轉發前綴: /api/v1/inventory

目標: inventory.twots.top
會員資料服務 需認證

使用者個人檔案、偏好設定與服務關聯資料

轉發前綴: /api/v1/member

目標: member.twots.top
廣告投放服務 需認證

內部站點推廣與行銷活動版位投放分析

轉發前綴: /api/v1/ads

目標: ads.twots.top
客戶支援服務 需認證

工單系統、問題回報與客戶諮詢互動管道

轉發前綴: /api/v1/support

目標: support.twots.top
備份還原服務 需認證

跨庫與異地安全備份排程，強制高階管理 MFA

轉發前綴: /api/v1/backup

目標: backup.twots.top 強制 MFA
AEMS 稽核存證服務 需認證

不可篡改 SHA-256 雜湊鏈存證日誌中心

轉發前綴: /api/v1/audit

目標: audit.twots.top
KMS 金鑰管理服務 需認證

平台機敏憑證、對稱金鑰與數位簽章管理中心

轉發前綴: /api/v1/keys

目標: keys.twots.top 強制 MFA
排程工作引擎 需認證

非同步定時排程、健康探針與過期快取清理引擎

轉發前綴: /api/v1/scheduler

目標: scheduler.twots.top
監控預警服務 需認證

服務負載、HTTP 錯誤率監控與即時警報分派

轉發前綴: /api/v1/monitor

目標: monitor.twots.top
平台管理後台 需認證

全系統營運控制中樞，強制最高管理員權限

轉發前綴: /api/v1/control

目標: control.twots.top 強制 MFA

安全架構與開發者接入規範

所有呼叫 API Gateway 之客戶端與內部模組皆必須嚴格遵循以下協議規範。

🛡️ 身分標頭洗滌 (Anti-Spoofing)

進站請求中任何客戶端偽造之 X-User-ID、X-User-Roles、X-Internal-* 等標頭將在進站第一時間被強制抹除。轉發時僅注入由 UIP JWT 解密核實之真實身分宣告。

⏱️ 防重放防護 (Replay Protection)

重要操作強制附帶 X-Timestamp（偏差超過 ±300 秒將被阻斷）與 X-Nonce（透過 MySQL 原子寫入保證唯一性，重複即拒絕）。

🔁 冪等性保障 (Idempotency)

針對 POST/PUT/DELETE 關鍵寫入請求，客戶端可提供 X-Idempotency-Key。閘道保證 24 小時內相同金鑰與相同內容之請求直接回傳快取結果，防範重複扣款或多次寫入。

💧 多維度漏桶限流 (Rate Limiting)

適配 cPanel 共享主機環境，透過 MySQL 原子更新計數。未認證訪客 IP 限制 60 次/分鐘，已認證會員 UID 限制 180 次/分鐘，超出即回傳 429 Too Many Requests。

⚡ 熔斷器容錯 (Circuit Breaker)

當單一微服務連續 5 次連線失敗或回應 5xx 錯誤時，閘道立即啟動 60 秒熔斷隔離 (OPEN)，保護整體架構避免雪崩效應。

🔗 全域分散式呼叫鏈 (X-Request-ID)

全站自動產生或繼承 UUIDv4 呼叫鏈標頭，貫穿 API Gateway、下游各微服務與 AEMS 不可篡改稽核日誌，確保每一筆請求全生命週期可追溯。

標準呼叫範例 (cURL / HTTP)

呼叫示例展示標準身分權杖、時間戳與 Nonce 之傳遞方式。

curl -X GET "https://gateway.twots.top/api/v1/uip/oauth/providers" \
     -H "Authorization: Bearer <USP_JWT_TOKEN>" \
     -H "X-Request-ID: $(uuidgen)" \
     -H "X-Timestamp: $(date +%s)" \
     -H "X-Nonce: $(openssl rand -hex 16)" \
     -H "Accept: application/json"