纳米体育数据足球数据接口：基础数据包接口文档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

  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)

  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

  更新时间

  }]

  }