中国篮协大数据平台接口规范与接入流程.docx
附件一
中国篮协大数据平台接口规范与接入流程
中国篮协
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
否
户口所