首页 状态 接口 查询 接入 赞助MCIM 首页 状态 接口 查询 接入 赞助
主题
跟随系统 亮色 暗色
语言
中文English
关闭
入门平台语义规范

缓存日期

sync_at 与 checked_at 的含义,以及启动器该怎样对待缓存响应。

MCIM 返回的是缓存,不是实时转发。每个来自缓存的响应都带有该条目的缓存日期。

sync_at

sync_at 是条目最后一次真正从上游拉取并写入缓存的时间,格式 YYYY-MM-DDTHH:MM:SSZ。同一个响应里可能有多个 sync_at,分别对应响应的不同部分,例如一个项目的不同版本。

checked_at

checked_at 是条目最后一次与上游核对、确认没有变化的时间。刷新任务每轮都会给核对过的条目更新 checked_at,不管内容有没有变,而 sync_at 只在更改时才更新。

启动器应该怎么做

MCIM 有可能随着风控策略的变化无法及时更新缓存。启动器应当自行检查缓存日期,决定是否信任响应;对时效敏感的场景,比如刚发布的版本,应该直接请求官方接口核对。

未命中会怎样

收到缓存里没有对应数据的请求时,镜像会返回 404,同时把请求内容放进主动抓取队列,稍后从上游拉取。稍后重试通常就能命中。抓取任务的运行情况见 同步状态,单个条目的缓存信息可以用 条目查询 查。