数据与同步约定

响应结构与字段

列表返回 data 和 pagination；详情返回 data。字段采用 snake_case；字段无数据时返回 null，请按接口定义处理可空值。

{
  "data": [],
  "pagination": {
    "total": 0,
    "limit": 50,
    "offset": 0
  }
}

ID 与时间

对外 ID 为 12 位字符串，按字符串保存。时间采用 ISO 8601 并携带时区偏移；统一业务时区为 Asia/Shanghai（+08:00）。

分页

limit 默认 50，最大 200；赔率批量接口上限 50。offset 默认 0。以各接口参数表为准，按 pagination.total 和实际返回条数继续翻页。

增量同步

支持 updated_since 的接口可按更新时间增量获取。传入 ISO 8601 时间，不带偏移时按 +08:00 解释。下一次游标取上次响应中最大的 updated_at，不要使用本地请求时间，以免漏掉延迟更新的数据。

按需获取子数据

include 使用重复查询参数，例如 ?include=events&include=lineups，不接受逗号拼接。可选值与支持范围见具体接口。