数据新鲜度
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 参考 或查看 错误和重试.