數據新鮮度
Narwhal 會儲存已接受的官方發布數據,並在你的 API 請求期間直接提供這些數據,而不會呼叫來源。
“新鮮”指 Narwhal 已驗證併發布的最新完整官方版本。它不表示每次客戶請求都會實時呼叫官方來源。
回應來自哪裡
每個成功的 REST 或 MCP 請求都會讀取 Narwhal 儲存的當前發布版本。來源網站、文件和 API 由攝取系統單獨檢查。
這樣可以使客戶回應時間不受官方來源速度或臨時中斷影響。
數據發布版本如何更新
- 排程任務會檢查官方來源是否有新發布版本。
- Narwhal 會獲取發布並檢查其身份、期間、欄位和完整性。
- 標準化後的觀測值與支援證據一同儲存。
- 只有整份發布內容通過驗證後,Narwhal 才會將其作為返回給客戶的版本。
不完整或無效的候選版本絕不會混入公開回應。
新鮮度欄位是什麼意思
| 欄位或信號 | 含義 |
|---|---|
period | 官方觀測值所代表的月份、季度或年份。 |
released_on | 官方發布日期。它不是 Narwhal 的獲取或發布時間。 |
| 最新 請求 | 省略 period 請求 Narwhal 當前儲存的最新完整已接受發布版本。 |
| 指定期間的請求 | 通過 period 當該確切發布期間仍在當前官方版本中可用時,請求該期間。 |
公開測試版回應目前不會暴露 Narwhal 的攝取時間戳記。如果已知發布版本似乎延遲,請使用官方發布日曆,並向支援團隊提供請求 ID。
來源檢查失敗時
Narwhal 會保留最近一次接受的發布數據供使用。它不會刪除該數據、將缺失值替換為零,也不會發布不完整的更新。
失敗的源檢查會按排程重試。如果 Narwhal 無法安全提供已接受的發布版本,請求會失敗並返回文件化的 503 問題,而不是返回不確定的數據。
公開測試版須知
- Narwhal 不會將缺失值編造、前向填充或轉換為零。
- 客戶 API 延遲衡量讀取已儲存數據所需的時間,而不是攝取新官方發布所需的時間。
- 官方機構可以修訂某個期間;因此,之後接受的發布內容可能替換此前儲存的值。
繼續使用該 Economics API 參考 或查看 錯誤和重試.