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

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

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

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

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

---

以下为纳米足球数据接口文档中足球——实时数据包——获取赛程赛果列表-日期查询接口文档展示：

获取赛程赛果列表-日期查询

该接口返回所请求日期的全量赛程赛果数据（请求限制：前后30天）
注：实时数据的获取通过实时统计数据接口

当天赛程 建议请求频次：10min/次（全量更新）
未来赛程 建议请求频次：30min/次（全量更新）

请求参数：TREE

• userstring

  用户名，请联系商务

  必填

• secretstring

  用户密钥，请联系商务

  必填

• datestring

  查询日期，格式为yyyymmdd（20200101）

返回参数：TREE 

{

code:

integer

query: {

查询

total: integer

返回数据总量

type: string

查询类型，日期查询：diary、赛事查询：competition、赛季查询：season、体彩查询：lottery

}results: {match:[

比赛列表

 {

比赛列表

id: integer

比赛id

season_id: integer

赛季id

competition_id: integer

赛事id

home_team_id: integer

主队id

away_team_id: integer

客队id

status_id: integer

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

match_time: integer

比赛时间

neutral: integer

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

note: string

备注

home_scores:[

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

Enum:Array[7]

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

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

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

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

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

]away_scores:[

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

Enum:Array[7]

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

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

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

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

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

]home_position: string

主队排名

away_position: string

客队排名

coverage: {

动画、情报、阵容 字段

mlive: integer

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

intelligence: integer

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

lineup: integer

是否有阵容，1-是、0-否

}venue_id: integer

场馆id

referee_id: integer

裁判id

related_id: integer

双回合中另一回合比赛id

agg_score:[

双回合常规时间(包括加时时间)总比分 字段说明
example：[3, 6]

Enum:Array[2]

0:"主队比分 - int"

1:"客队比分 - int"

]round: {

关联信息

stage_id: integer

阶段id

group_num: integer

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

round_num: integer

第几轮

}environment: {

比赛环境,有数据才有此字段

weather: integer

天气id
1:局部有云
2:多云
3:局部有云/雨
4:雪
5:晴
6:阴有雨/局部有雷暴
7:阴
8:薄雾
9:阴有雨
10:多云有雨
11:多云有雨/局部有雷暴
12:局部有云/雨和雷暴
13:雾

pressure: string

气压

temperature: string

温度

wind: string

风速

humidity: string

湿度

}updated_at: integer

更新时间

}]competition:[

赛事列表

 {id: integer

赛事id

name: string

赛事名称

logo: string

赛事logo

}]team:[

球队列表

 {id: integer

球队id

name: string

球队名称

logo: string

球队logo

}]}

}