浏览全部文档

数据新鲜度

Narwhal 会存储已接受的官方发布数据,并在你的 API 请求期间直接提供这些数据,而不会调用来源。

“新鲜”指 Narwhal 已验证并发布的最新完整官方版本。它不表示每次客户请求都会实时调用官方来源。

响应来自哪里

每个成功的 REST 或 MCP 请求都会读取 Narwhal 存储的当前发布版本。来源网站、文件和 API 由摄取系统单独检查。

这样可以使客户响应时间不受官方来源速度或临时中断影响。

数据发布版本如何更新

  1. 计划任务会检查官方来源是否有新发布版本。
  2. Narwhal 会获取发布并检查其身份、期间、字段和完整性。
  3. 标准化后的观测值与支持证据一同存储。
  4. 只有整份发布内容通过验证后,Narwhal 才会将其作为返回给客户的版本。

不完整或无效的候选版本绝不会混入公开响应。

新鲜度字段是什么意思

字段或信号含义
period官方观测值所代表的月份、季度或年份。
released_on官方发布日期。它不是 Narwhal 的获取或发布时间。
最新 请求省略 period 请求 Narwhal 当前存储的最新完整已接受发布版本。
指定期间的请求通过 period 当该确切发布期间仍在当前官方版本中可用时,请求该期间。

公开测试版响应目前不会暴露 Narwhal 的摄取时间戳。如果已知发布版本似乎延迟,请使用官方发布日历,并向支持团队提供请求 ID。

来源检查失败时

Narwhal 会保留最近一次接受的发布数据供使用。它不会删除该数据、将缺失值替换为零,也不会发布不完整的更新。

失败的源检查会按计划重试。如果 Narwhal 无法安全提供已接受的发布版本,请求会失败并返回文档化的 503 问题,而不是返回不确定的数据。

公开测试版须知

  • Narwhal 不会将缺失值编造、前向填充或转换为零。
  • 客户 API 延迟衡量读取已存储数据所需的时间,而不是摄取新官方发布所需的时间。
  • 官方机构可以修订某个期间;因此,之后接受的发布内容可能替换此前存储的值。

继续使用该 Economics API 参考 或查看 错误和重试.