Narwhal 如何保持官方数据更新

你的请求读取存储数据

请求CPI、GDP、劳动力或贸易数据时，Narwhal会从数据库读取最新已接受发布。请求等待期间不会调用官方发布机构。

这将客户响应时间与获取和检查新发布版本的工作分开。来源网站缓慢可能延迟源检查，但不会让每个客户请求都等待该网站。

发布版本必须整体通过

新数据只有在完整发布通过验证后才会公开。更新路径刻意保持简单：

• 计划任务会检查官方来源。
• Narwhal 会获取发布并检查其身份、期间、字段和完整性。
• 规范化后的观测值及其来源证据一并存储。
• 完整发布只有通过所有必需检查后，才会成为当前客户版本。

检查失败不会删除有效数据

官方网站可能超时，文件可能不完整，格式也会变化。如果候选发布未通过验证，Narwhal 会保留上一次已接受的发布内容供使用。它不会将数值替换为零，也不会把失败发布的一部分与上一次发布合并。

如果 Narwhal 没有可以安全提供的发布数据，API 会返回文档中说明的 503 错误，而不是捏造结果。

按字面读取日期

period 字段告诉你观测值涵盖哪个月、季度或年份。released_on 字段是该发布版本提供的官方发布日期。

公开测试版不会暴露 Narwhal 摄取时间戳，也不承诺从来源发布到 API 发布的固定延迟。这些日期描述经济观测值及其官方发布，而不是 API 调用速度。

修订会替换较早的值

经济机构会定期修订已发布的数值。修订后的官方发布通过相同检查后，可以替换该期间之前存储的数值。应用应把官方经济数据视为可以修订的已发布数据，而不是不可变的事件日志。