文件
資料時效
Narwhal 會儲存已接受的官方發布資料，在你的 API 請求期間直接提供這些資料，不會呼叫來源。
「最新」是指 Narwhal 已驗證並發布的最新完整官方發布版本，並不表示每次客戶請求都會即時呼叫官方來源。
回應來自哪裡
每個成功的 REST 或 MCP 請求都會讀取 Narwhal 儲存的目前發布版本。資料匯入系統會另外檢查來源網站、檔案和 API。
這樣可以使客戶回應時間不受官方來源速度或臨時中斷影響。
資料發布版本如何更新
- 排程任務會檢查官方來源是否有新發布版本。
- Narwhal 會取得來源資料，並驗證其身分、期間、欄位與完整性。
- 標準化後的觀測值與佐證資料會一併儲存。
- 只有整份發布內容通過驗證後，Narwhal 才會將其作為回傳給客戶的版本。
不完整或無效的候選版本絕不會混入公開回應。
資料時效欄位的意義
| 欄位或訊號 | 含義 |
|---|---|
period | 官方觀測值所代表的月份、季度或年份。 |
released_on | 官方發布日期。它不是 Narwhal 的取得或發布時間。 |
| 最新資料請求 | 省略 period 請求 Narwhal 目前儲存且已接受的最新完整發布版本。 |
| 指定期間的請求 | 通過 period 當該確切發布期間仍在當前官方版本中可用時，請求該期間。 |
公開測試版的回應目前不提供 Narwhal 的資料匯入時間戳記。若已知的發布資料似乎有所延遲，請參考官方發布日曆，並向支援團隊提供請求 ID。
來源檢查失敗時
Narwhal 會保留最近一次接受的發布資料供使用，不會刪除該資料、將缺失值替換為零，也不會發布不完整的更新。
來源檢查失敗後會依排程重試。如果 Narwhal 無法安全提供已接受的發布版本，請求就會失敗，並回傳文件中說明的 503 問題，而非回傳不確定的資料。
公開測試版須知
- 測試期間，Narwhal 不保證從來源發布到 Narwhal 發布之間的延遲固定。
- 客戶 API 的延遲衡量的是讀取已儲存資料所需的時間，而非匯入最新官方發布資料所需的時間。
- 官方機構可以修訂某個期間；因此，之後接受的發布內容可能替換此前儲存的值。
- Narwhal API 的核心端點與 MCP 工具提供的主要經濟指標數值可能是首次發布的暫估值，回應不會註明其為暫估值；來源發布最終數值後，這些值就會被替換。
接著使用 經濟數據 API 參考 或查看 錯誤和重試。