响应结构

成功响应

{
  "data": { ... },
  "meta": {
    "request_id": "aeb2b2b8777c4c61",
    "generated_at": "2026-10-01T08:09:57Z",
    "cache": "hit",
    "data_age_seconds": 96,
    "stale_since": null,
    "delay_seconds": null
  }
}

• data：业务数据，结构见各接口文档
• meta.request_id：请求 ID，反馈问题时请一并提供
• meta.cache：hit / miss / stale
• meta.data_age_seconds、meta.stale_since、meta.delay_seconds：见「数据新鲜度」
• 列表接口的 data 为 { items, total, page, page_size }；游标分页接口为 { items, next_cursor }

错误响应

{ "error": { "code": "not_found", "message": "feed not found", "request_id": "…" } }

错误码见「错误码」。

兼容性

/v1 冻结后只增加字段、不删除也不改变已有字段的含义；破坏性变更会以 /v2 发布并保留过渡期。客户端请忽略不认识的字段。