纳米体育数据篮球数据接口：实时数据包接口文档API示例①

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

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

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

---

获取变动比赛列表

用于获取比赛变动后的数据（比赛时间、状态等），可根据时间戳增量获取新增或变动的数据
限制：前30天比赛开始

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

请求参数：TREE

• userstring

  用户名，请联系商务

  必填

• secretstring

  用户密钥，请联系商务

  必填

• idinteger

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

• timeinteger

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

• limitinteger

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

返回参数：TREE

{

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

competition_id: integer

赛事id

home_team_id: integer

主队id

away_team_id: integer

客队id

kind: integer

类型id，1-常规赛、2-季后赛、3-季前赛、4-全明星、5-杯赛、6-附加赛、0-无

period_count: integer

比赛总节数(不包含加时)

status_id: integer

比赛状态，详见状态码->比赛状态

match_time: integer

比赛时间

neutral: integer

是否中立场，1-是、0-否

home_scores:[

比分字段说明
example：[0, 0, 0, 0, 0]

Enum:Array[5]

0:"第1节分数 - int"

1:"第2节分数 - int"

2:"第3节分数 - int"

3:"第4节分数 - int"

4:"加时分数 - int"

]away_scores:[

比分字段说明
example：[0, 0, 0, 0, 0]

Enum:Array[5]

0:"第1节分数 - int"

1:"第2节分数 - int"

2:"第3节分数 - int"

3:"第4节分数 - int"

4:"加时分数 - int"

]over_time_scores:[

加时赛比分字段说明（大于1个加时才有该字段，每一位为1节加时比分）
example：[[8, 9, 6], [8, 9, 8]]

Enum:Array[2]0:Array[3]

0:"主队第1节加时分数 - int"

1:"主队第2节加时分数 - int"

2:"主队第n节加时分数 - int"

1:Array[3]

0:"客队第1节加时分数 - int"

1:"客队第2节加时分数 - int"

2:"客队第n节加时分数 - int"

]home_position: string

主队排名

away_position: string

客队排名

coverage: {

动画、情报 字段

mlive: integer

是否有动画，1-是、0-否

intelligence: integer

是否有情报，1-是、0-否

}venue_id: integer

场馆id

season_id: integer

赛季id

round: {

关联信息

stage_id: integer

阶段id

group_num: integer

第几组，1-A、2-B以此类推

round_num: integer

第几轮

}updated_at: integer

更新时间

}]

}