纳米体育数据足球数据接口：基础数据包接口文档API示例⑨

纳米体育数据的数据接口通过JSON拉流方式获取200多个国家的体育赛事实时数据或历史数据的编程接口，无请求次数限制，可按需购买，接口稳定高效；覆盖项目包括足球、篮球、网球、电子竞技、奥运等专题、数据内容。

纳米数据API2.0版本包含http协议以及websocket协议，主要通过http获取数据，实时数据通过websocket获取。

http协议支持http和https，每个接口都需要传递用户名和密钥用于验证接口权限，白名单ip才能够获取相关数据。

websocket协议域名为s.sportnanoapi.com，通过mqtt的websocket协议实现，用户名、密钥和白名单ip必须正确才能订阅数据，否则无法授权，api通过java、python示例，同时也包含其他语言。

---

以下为纳米足球数据接口文档中足球——基础数据包——获取阶段列表、获取数据更新的接口文档展示：

获取阶段列表

返回全量阶段数据，可根据时间戳增量获取新增或变动的数据

1、首次全量更新，根据参数id获取全量数据
2、后续增量更新，根据参数time增量获取变动数据（建议请求频次：1min/次）

请求参数：FREE

userstring

用户名，请联系商务

secretstring

用户密钥，请联系商务

idinteger

查询大于等于id的记录，根据id排序

timeinteger

查询大于等于更新时间的记录(时间戳)，根据更新时间排序

limitinteger

 返回数据最大数，默认为1000，最大为1000

返回参数：FREE

{

code:

integer

query: {

查询情况

total: integer

返回数据总量

type: string

查询类型，id查询：sequence、time查询：time，默认sequence

id: integer

查询id值，默认为0（id查询，字段返回）

min_id: integer

返回数据最小id（id查询，字段返回）

max_id: integer

返回数据最大id（id查询，字段返回）

limit: integer

可返回数据最大数（id查询，字段返回）

time: integer

查询time值（time查询，字段返回）

min_time: integer

返回数据最小time(更新时间戳)（time查询，字段返回）

max_time: integer

返回数据最大time(更新时间戳)（time查询，字段返回）

}results:[ {

阶段列表

id: integer

阶段id

season_id: integer

赛季id

name_zh: string

中文名称

name_zht: string

粤语名称

name_en: string

英文名称

mode: integer

比赛模式，1-积分赛、2-淘汰赛

group_count: integer

总组数

round_count: integer

总轮数

order: integer

排序，阶段的先后顺序

updated_at: integer

更新时间

}]

}

获取数据更新

返回最近120秒内变动数据，可在对应接口获取更新，需定时同步
建议请求频次：20秒/次

请求参数：FREE

• userstring

  用户名，请联系商务

• secretstring

  用户密钥，请联系商务

• {

  code:

  integer

  results: {类型id:[

  数据类型id，详见状态码->数据更新类型ID

   {match_id: integer

  比赛id（单场阵容、集锦录像 字段存在）

  season_id: integer

  赛季id（对阵图、积分榜、赛季统计 字段存在）

  competition_id: integer

  赛事id（积分榜、赛季统计 字段存在）

  pub_time: integer

  排名发布时间（fifa men、fifa women 字段存在）

  update_time: integer

  更新时间

  }]}

  }