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

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

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

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

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

---

以下为纳米足球数据接口文档中足球——实时数据包——获取实时统计数据接口文档展示：

获取实时统计数据

返回最近120min内的比赛事件、技术统计、文字直播数据（全量更新）
ps：非120min内的比赛数据有更新，也会同步返回
建议请求频次：2s/次

比赛进行分钟数获取公式
上半场：比赛进行分钟数=(当前时间戳-上半场开球时间戳) / 60 + 1
下半场：比赛进行分钟数=(当前时间戳-下半场开球时间戳) / 60 + 45 + 1

stats 比赛统计字段说明
包含：角球、黄牌、红牌、点球、射正、射偏、进攻、危险进攻、控球率

incidents 比赛事件字段说明
包含：黄牌、两黄变红、红牌、进球(助攻)、换人、点球、点球未进、乌龙球、VAR、中场、伤停补时、结束、加时结束、点球大战结束

tlive 文字直播字段说明
包含：黄牌、红牌、进球、换人、角球、越位、助攻、比赛开始、中场、结束

请求参数：TREE

• userstring

  用户名，请联系商务

• secretstring

  用户密钥，请联系商务

返回参数：TREE

{

code:

integer

results:[ {

实时数据

id: integer

比赛id

score:[

比分字段说明
example：[2783605,8,[1, 0, 0, 0, -1, 0, 0],[1, 0, 0, 0, -1, 0, 0],0,""]

Enum:Array[6]

0:"纳米比赛id - int"

1:"比赛状态，详见状态码->比赛状态 - int"

2:Array[7]

0:"主队比分(常规时间) - int"

1:"主队半场比分 - int"

2:"主队红牌 - int"

3:"主队黄牌 - int"

4:"主队角球，-1表示没有角球数据 - int"

5:"主队加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"主队点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

3:Array[7]

0:"客队比分(常规时间) - int"

1:"客队半场比分 - int"

2:"客队红牌 - int"

3:"客队黄牌 - int"

4:"客队角球，-1表示没有角球数据 - int"

5:"客队加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"客队点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

4:"开球时间戳，上/下半场开球时间(根据比赛状态判断) - int"

5:"备注信息，可忽略 - string"

]stats:[

比赛统计字段说明，可能不存在

 {

比赛统计字段说明

type: integer

类型，详见状态码->技术统计

home: integer

主队值

away: integer

客队值

}]incidents:[

比赛事件字段说明，可能不存在

 {

比赛事件字段说明

type: integer

类型，详见状态码->技术统计

position: integer

事件发生方，0-中立、1-主队、2-客队

time: integer

时间(分钟)

second: integer

时间

player_id: integer

事件相关球员id，可能不存在
assist1-助攻球员1
assist2-助攻球员2
in_player-换上球员
out_player-换下球员

player_name: string

事件相关球员名称，可能不存在

home_score: integer

主队比分（进球、未进球 事件存在）

away_score: integer

客队比分（进球、未进球 事件存在）

var_reason: integer

VAR原因（VAR事件存在）
1-进球判定
2-进球未判定
3-点球判定
4-点球未判定
5-红牌判定
6-出牌处罚判定
7-错认身份
0-其他

var_result: integer

VAR结果（VAR事件存在）
1-进球有效
2-进球无效
3-点球有效
4-点球取消
5-红牌有效
6-红牌取消
7-出牌处罚核实
8-出牌处罚更改
9-维持原判
10-判罚更改
0-未知

reason_type: integer

红黄牌、换人事件原因，详见状态码->事件原因（红黄牌、换人事件存在）

}]tlive:[

文字直播字段说明，可能不存在

 {

文字直播字段说明

main: integer

是否重要事件，1-是、0-否

type: integer

类型，详见状态码->技术统计

position: integer

事件发生方，0-中立、1-主队、2-客队

time: string

事件时间(分钟)

data: string

事件内容

}]}]

}