Narwhal 如何保持官方數據更新

你的請求讀取儲存數據

請求CPI、GDP、勞動力或貿易數據時，Narwhal會從數據庫讀取最新已接受發布。請求等待期間不會呼叫官方發布機構。

這將客戶回應時間與獲取和檢查新發布版本的工作分開。來源網站緩慢可能延遲源檢查，但不會讓每個客戶請求都等待該網站。

發布版本必須整體通過

新數據只有在完整發布通過驗證後才會公開。更新路徑刻意保持簡單：

• 排程任務會檢查官方來源。
• Narwhal 會獲取發布並檢查其身份、期間、欄位和完整性。
• 規範化後的觀測值及其來源證據一並儲存。
• 完整發布只有通過所有必需檢查後，才會成為當前客戶版本。

檢查失敗不會刪除有效數據

官方網站可能超時，文件可能不完整，格式也會變化。如果候選發布未通過驗證，Narwhal 會保留上一次已接受的發布內容供使用。它不會將數值替換為零，也不會把失敗發布的一部分與上一次發布合併。

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

按字面讀取日期

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

公開測試版不會暴露 Narwhal 攝取時間戳記，也不承諾從來源發布到 API 發布的固定延遲。這些日期描述經濟觀測值及其官方發布，而不是 API 呼叫速度。

修訂會替換較早的值

經濟機構會定期修訂已發布的數值。修訂後的官方發布通過相同檢查後，可以替換該期間之前儲存的數值。應用應把官方經濟數據視為可以修訂的已發布數據，而不是不可變的事件日誌。