文档
数据时效性
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 参考 或查看 错误和重试。