体育数据API纳米足球数据API：足球数据接口文档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/次）

请求参数：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

name_zh: string

中文名称

name_zht: string

粤语名称

name_en: string

英文名称

short_name_zh: string

中文简称

short_name_zht: string

粤语简称

short_name_en: string

英文简称

logo: string

球员logo

country_id: integer

国家id

nationality: string

国籍

national_logo: string

球员logo(国家队，可判断球队是国家队时使用)

birthday: integer

生日（0-未知）

age: integer

年龄

height: integer

身高

weight: integer

体重

market_value: integer

市值

market_value_currency: string

市值单位

contract_until: integer

合同截止时间

preferred_foot: integer

惯用脚，0-未知、1-左脚、2-右脚、3-左右脚

suffix: string

球员u系列

coach_id: integer

教练id(球员转为教练后的对应id)

uid: integer

球员id(重复球员合并后的对应id)

ability:[

能力评分（没有字段不存在）

[

能力评分字段说明：
1-扑救
2-预判
3-处理球
4-空中
5-战术
6-进攻
7-防守
8-创造力
9-技术

example：[6, 99, 67]

Enum:Array[3]

0:"类型 - int"

1:"评分，满分100 - int"

2:"平均分，满分100 - int"

]]characteristics:[

技术特点字段说明（没有字段不存在）：
1-卸球
2-罚点球
3-任意球
4-远射
5-临门一脚
6-传球
7-组织进攻
8-带球
9-断球
10-铲球
11-稳定性
12-过人
13-长传
14-控球
15-空中对抗
16-地面对抗
17-失误倾向
18-纪律性
19-扑点球
20-反应
21-弃门参与进攻
22-高球拦截
23-处理球
24-远距离射门
25-站位
26-高位紧逼
27-远射扑救
28-传中
29-越位意识
30-近射扑救
31-专注度
32-防守参与度
33-关键传球
34-头球
35-定位球
36-直传球
37-反击
38-一脚出球
39-起高球
40-造犯规
41-内切
42-拳击球
43-解围

example：[[[11, 1]], [[7, 1]]]

Enum:Array[2]0:Array[1]0:Array[2]

0:"优点：类型，没有为空 - int"

1:"排名（世界范围，0-未知） - int"

1:Array[1]0:Array[2]

0:"缺点：类型，没有为空 - int"

1:"排名（世界范围，0-未知） - int"

]position: string

擅长位置，F-前锋、M-中场、D-后卫、G-守门员、其他为未知

positions:[

详细位置字段说明（没有字段不存在）：
'LW'-左边锋
'RW'-右边锋
'ST'-前锋
'AM'-攻击型中场
'ML'-左中场
'MC'-中路中场
'MR'-右中场
'DM'-防守型中场
'DL'-左后卫
'DC'-中后卫
'DR'-右后卫
'GK'-守门员

example：["RW", ["ST"]]

Enum:Array[2]

0:"主要位置 - string"

1:Array[1]

0:"次要位置列表 - string"

]updated_at: integer

更新时间

}]

}