公共入参 - AnySport

绝大多数 REST 接口都会用到下面这三个参数中的一个或几个。它们的语义在所有接口中保持一致，因此单独列在这里说明，具体每个接口是否支持、是否必填，以该接口自己的入参表为准。

参数	类型	必填	默认	说明
`lang`	string	否	en	名称类字段语言。当前支持 `en`（英语）；`zh-CN`（简体中文）逐步开放
`page`	int	否	1	页码，从 1 开始（分页接口）
`limit`	int	否	50	每页条数，范围 1~100（分页接口）

lang：多语言名称

lang 影响的是名称类字段的语言——比如国家名、联赛名、球队名、球员名等人类可读文本；不会影响 ID、日期、数字等结构化字段的格式。不传 lang 时默认返回英文名。

# 返回英文联赛名
GET /v1/soccer/leagues?league_id=asl_62db...&lang=en

# 返回中文联赛名（覆盖范围逐步扩大）
GET /v1/soccer/leagues?league_id=asl_62db...&lang=zh-CN

zh-CN 的翻译覆盖范围正在持续扩大中，不同实体类型（国家/联赛/球队/球员）的翻译完整度可能不一致。如果业务场景对多语言展示要求较高，建议在前端做好”未翻译时回退到英文名”的兜底展示。

只有明确标注”分页接口”的接口才支持这两个参数；把它们传给不支持分页的接口不会报错，但也不会生效。

如果你需要拉取某类资源的全量数据（比如全部国家、全部联赛），建议按 limit=100 的上限分页遍历，而不是尝试一次性拉取全部——这样既符合接口设计，也能让你的客户端更平滑地处理大数据量场景。