数据新鲜度
平台把“数据有多新”作为一等信息返回,不会把过期数据悄悄当作最新数据。
三个字段
meta.data_age_seconds:距最近一次确认榜单内容的秒数。内容没变化时快照不会更换,但每次成功抓取都会刷新确认时间meta.stale_since:数据过期时为最后一次成功确认的时间,未过期为null。榜单超过刷新周期 3 倍(至少 15 分钟)未成功确认即视为过期;此时接口仍返回最后一次快照,而不是报错meta.delay_seconds:套餐的刻意延迟(例如匿名端点延迟 30 分钟),实时数据为null
建议用法
- 展示数据时同时展示“N 分钟前更新”,依据
data_age_seconds stale_since非空时提示用户数据可能不是最新- 轮询频率不必高于榜单本身的刷新周期(
update_interval_seconds)