公开 API
HTTP 缓存与条件请求
明确哪些端点支持 ETag,以及何时复用正文。
保存完整响应正文及其 ETag,下次请求通过 If-None-Match 验证。
字段
类型
304 没有正文,只能复用同一个 URL 先前保存的表示。首次请求或本地正文丢失时,不要只发送旧 ETag。优先使用 If-None-Match;条件请求仍可能消耗限流额度。
发布返回 200 不代表外站同步、搜索和 RSS 已完成更新。外站进度应查询同步状态接口;不要把一次观测到的延迟当作完成时限。
明确哪些端点支持 ETag,以及何时复用正文。
保存完整响应正文及其 ETag,下次请求通过 If-None-Match 验证。
字段
类型
304 没有正文,只能复用同一个 URL 先前保存的表示。首次请求或本地正文丢失时,不要只发送旧 ETag。优先使用 If-None-Match;条件请求仍可能消耗限流额度。
发布返回 200 不代表外站同步、搜索和 RSS 已完成更新。外站进度应查询同步状态接口;不要把一次观测到的延迟当作完成时限。