Narwhal 如何保持官方資料更新

Narwhal 如何檢查官方發布版本、驗證完整發布內容,並持續提供上一次已接受的資料。

Narwhal 在官方數據發布進入 API 之前進行檢查

你的請求讀取已儲存的資料

當你請求 CPI、GDP、勞動力或貿易資料時,Narwhal 會從資料庫讀取最新已接受的發布版本,不會在請求等待期間呼叫官方發布機構。

這讓客戶請求的回應時間不受取得及檢查新發布版本所需時間的影響。來源網站緩慢可能延遲來源檢查,但不會讓每個客戶請求都等待該網站。

發布版本必須整體通過

新資料只有在完整發布版本通過驗證後才會公開。更新流程刻意保持簡單:

  • 排程任務會檢查官方來源。
  • Narwhal 會取得發布版本,並檢查其識別資訊、期間、必要欄位和完整性。
  • 標準化後的觀測值及其來源證據會一併儲存。
  • 完整發布版本只有通過所有必要檢查後,才會成為目前供客戶使用的版本。

檢查失敗不會刪除有效資料

官方網站可能逾時,檔案可能不完整,格式也會改變。如果候選發布版本未通過驗證,Narwhal 會繼續提供上一次已接受的版本。它不會將數值替換為零,也不會將未通過驗證的發布內容與上一次發布版本混合。

如果 Narwhal 沒有可以安全提供的發布資料,API 會回傳文件中說明的 503 錯誤,而不是捏造結果。

按字面讀取日期

period 欄位告訴你觀測值涵蓋哪個月、季度或年份。released_on 欄位是該發布版本提供的官方發布日期。

公開測試版不公開 Narwhal 的資料匯入時間戳記,也不承諾從來源發布到 API 發布之間有固定延遲。這些日期描述的是經濟觀測值及其官方發布時間,而非 API 呼叫速度。

修訂會替換較早的值

經濟機構會定期修訂已發布的數值。修訂後的官方發布版本通過相同檢查後,可以替換該期間先前儲存的數值。應用程式應將官方經濟數據視為可修訂的發布資料,而非不可變更的事件日誌。

將 503 視為涵蓋範圍訊號

503 表示 Narwhal 無法安全提供已接受的發布版本。請保留請求 ID,將資料標示為不可用,稍後採用設有上限的退避策略重試;不要自行改用其他國家的資料,也不要自行沿用舊值。

404 表示此次請求無法使用該路由或已核准的序列。重試前請檢查操作的涵蓋清單。歷史資料回應即使成功,仍可能存在實際的資料缺口,因為缺失的觀測值不會被填補。

來源與參考

發布日期: 。最近審閱日期: 。