瀏覽全部文件

數據新鮮度

Narwhal 會儲存已接受的官方發布數據,並在你的 API 請求期間直接提供這些數據,而不會呼叫來源。

“新鮮”指 Narwhal 已驗證併發布的最新完整官方版本。它不表示每次客戶請求都會實時呼叫官方來源。

回應來自哪裡

每個成功的 REST 或 MCP 請求都會讀取 Narwhal 儲存的當前發布版本。來源網站、文件和 API 由攝取系統單獨檢查。

這樣可以使客戶回應時間不受官方來源速度或臨時中斷影響。

數據發布版本如何更新

  1. 排程任務會檢查官方來源是否有新發布版本。
  2. Narwhal 會獲取發布並檢查其身份、期間、欄位和完整性。
  3. 標準化後的觀測值與支援證據一同儲存。
  4. 只有整份發布內容通過驗證後,Narwhal 才會將其作為返回給客戶的版本。

不完整或無效的候選版本絕不會混入公開回應。

新鮮度欄位是什麼意思

欄位或信號含義
period官方觀測值所代表的月份、季度或年份。
released_on官方發布日期。它不是 Narwhal 的獲取或發布時間。
最新 請求省略 period 請求 Narwhal 當前儲存的最新完整已接受發布版本。
指定期間的請求通過 period 當該確切發布期間仍在當前官方版本中可用時,請求該期間。

公開測試版回應目前不會暴露 Narwhal 的攝取時間戳記。如果已知發布版本似乎延遲,請使用官方發布日曆,並向支援團隊提供請求 ID。

來源檢查失敗時

Narwhal 會保留最近一次接受的發布數據供使用。它不會刪除該數據、將缺失值替換為零,也不會發布不完整的更新。

失敗的源檢查會按排程重試。如果 Narwhal 無法安全提供已接受的發布版本,請求會失敗並返回文件化的 503 問題,而不是返回不確定的數據。

公開測試版須知

  • Narwhal 不會將缺失值編造、前向填充或轉換為零。
  • 客戶 API 延遲衡量讀取已儲存數據所需的時間,而不是攝取新官方發布所需的時間。
  • 官方機構可以修訂某個期間;因此,之後接受的發布內容可能替換此前儲存的值。

繼續使用該 Economics API 參考 或查看 錯誤和重試.