跳轉到

服務狀態與可用率

FinMind 提供對外即時狀態頁:

status.finmindtrade.com

該頁顯示 API 目前狀態、過去 24 小時90 天的可用率(uptime),以及歷史事件紀錄。

此可用率即 FinMind 企業方案 SLA 的衡量基準——企業客戶的服務水準以同一套逐分鐘演算法衡量,與狀態頁所呈現者一致透明。

可用率怎麼計算

可用率以真實 API 流量、逐分鐘衡量。完整公式鏈如下:

1. 有效請求

有效請求 = 成功請求(2xx / 3xx) + server-side error
  • server-side error 指 HTTP 5xx 回應,以及因伺服器端逾時而中斷的連線(HTTP 499;多半是伺服器忙碌/變慢造成連線被中斷,視為伺服器端問題)。
  • 一般 client error(例如 400 / 403 / 404 / 429 等請求端錯誤,不含 499)不計入有效請求,也不影響可用率。

2. 逐分鐘錯誤率

逐分鐘錯誤率 = server-side error ÷ 有效請求
  • 某分鐘有流量且錯誤率 > 5%,該分鐘即記為 down(中斷)
  • 沒有流量的分鐘不計入可用率。

3. 可用率

可用率 % =(有流量的分鐘數 − 中斷的分鐘數)÷ 有流量的分鐘數 × 100
  • 24 小時90 天數字由上述逐分鐘結果彙總;90 天與當月數字以有流量分鐘加權。
  • 計畫性維護時段可排除,不計入中斷。

狀態分級

某時間窗有流量時,依該窗的可用率分為四級:

狀態 可用率門檻
Operational 100%(有流量且無任何中斷分鐘)
Degraded Performance ≥ 99%(有中斷分鐘,但可用率仍 ≥ 99%)
Partial Outage 95% ~ 99%(95% ≤ 可用率 < 99%)
Major Outage < 95%
No data 該區間沒有流量

Tip

狀態頁底部也內含同樣的「How uptime is calculated」說明,可隨時查閱。