中国篮协大数据平台接口规范与接入流程.docxVIP

附件一

中国篮协大数据平台接口规范与接入流程

中国篮协

2024年12月25日

目录

TOC\o1-3\h\u17702569081.数据接入流程 3

14694072182.接入接口说明 3

2651724263.数据采集标准 4

7243962573.1球员 4

8430965563.2教练员基本信息 6

8267137863.3裁判基本信息 7

3594052123.4球队工作人员 8

17993827203.5赛事 10

13606579863.6比赛信息及技术统计 17

4.数据直播接口 36

19279576874.1单节数据 36

19515794734.2比赛双方球队信息以及比赛基本信息 37

16784620804.3主队球队统计 38

5669915684.4客队技术统计 38

10423416374.5主队球员统计 38

16117844804.6客队球员统计 38

9030321025.接入接口优先级 38

9936049656.视频摄制标准 39

6858076836.1视频数据所采用赛事镜头覆盖场地范围 39

8249947326.2视频数据采集赛事时间标准 40

15320356926.3赛事视频数据采集所需参赛信息 40

5949479146.4主机位摄像机位置要求(必备) 41

6057301666.5辅助摄像机位置要求(可选) 41

14344131826.6主机位画面要求 42

5309286526.7辅助摄像机画面要求 43

5233008796.8声音要求 44

11723388886.9比赛信息要求 44

3372293917.视频上传流程 45

6050301047.1申请账号 45

4058893837.2登录阿里云官网 45

13747972097.3进入OSS服务 46

14401335907.4上传视频到OSS 46

7.5检查上传结果 48

1272973217.6通过接口上传 49

数据接入流程

数据接入流程说明如下：

如数据为赛后完整静态数据，则按照第2、3、4节要求接入；如数据为比赛实时直播技统数据，则按照第5节要求接入。

赛事主办方按如下接口说明提供数据接口，并给中国篮协大数据平台开放接口授权

中国篮协对提供的数据接口进行测试，测试无问题即开始接入，接入过程中出现的问题需要接入方有相应技术人员配合联调

接入接口说明

请求方式

请求方式

GET

输入格式

URL编码

输出格式

json

编码

UTF-8

请求公共参数

参数

类型

必须

说明

customer

string

是

客户名

pageNo

int

否

有分页场景时添加

pageSize

int

否

有分页场景时添加

返回参数

参数

类型

说明

success

Boolean

接口调用是否成功，true：成功，false：失败

code

String

状态码

message

String

状态信息

result

JSONArray

数据列表，详见各接口明细文档（若不存在分页）

result

Object

分页信息（若存在分页）

records

JSONArray

数据列表，详见各接口明细文档

current

int

当前页

size

int

每页数据量

total

int

总数据量

pages

int

总页数

3.数据采集标准

球员

3.1.1球员基本信息

字段

英文名

字段类型

是否必传

说明

球员ID

player_id

string

是

中文名

name

string

是

英文名

en_name

string

否

国籍

country

string

是

性别

sex

int

是

0:男

1:女

民族

nation

string

否

出生日期

birthday

datetime

否

身高

height

double

否

体重

weight

double

否

身份证号

id_number

string

是

护照号

passport_no

string

否

港澳通行证

compatriot_id

string

否

非境内球员时必填

电话

phone

string

否

创建时间

create_time

datetime

否

修改时间

update_time

datetime

否

出生地省

birth_province

string

否

出生地市

birth_city

string

否

户口所