データの鮮度

Narwhal は受け入れた公式リリースを保存し、API リクエスト中にソースを呼び出さずに提供します。

「最新」とは、Narwhal が検証して公開した、完全な公式リリースのうち最も新しいものを意味します。顧客の各リクエストが公式ソースをリアルタイムで呼び出すという意味ではありません。

レスポンスの取得元

成功した各RESTまたはMCPリクエストは、Narwhalに保存された現在の公開内容を読み取ります。ソースのウェブサイト、ファイル、APIは取り込みシステムが別途確認します。

これにより、顧客へのレスポンス時間は公式ソースの速度や一時的な障害から独立します。

不完全または無効な候補が公開レスポンスに混在することはありません。

フィールドまたはシグナル	意味
`period`	公式観測値が表す月、四半期、または年。
`released_on`	公式公開日。Narwhal の取得時刻や公開時刻ではありません。
最新のリクエスト	省略 `period` Narwhal が現在保存している最新の受け入れ済み完全リリースをリクエストします。
期間を厳密に指定したリクエスト	渡す場合 `period` 現在の公式リリースで利用可能な場合、その公開済みの正確な期間をリクエストします。

パブリックベータのレスポンスでは、現在 Narwhal の取り込みタイムスタンプを公開していません。既知のリリースが遅れているように見える場合は、公式リリースカレンダーを確認し、リクエスト ID を添えてサポートへ連絡してください。

Narwhalは最後に受け入れた公開内容を利用可能なまま保持します。削除したり、欠落値をゼロに置き換えたり、部分的な更新を公開したりしません。

失敗したソースチェックはスケジュールに従って再試行されます。Narwhalが受け入れ済みの公開内容を安全に提供できない場合、リクエストは文書化された 503 不確かなデータを返す代わりに問題を返します。