历史数据全量同步
GET
/datashare/allHistoryData
接口描述
过往赛季的历史数据，包括当前赛季，联赛范围根据购买的范围决定。根据返回的文件地址，获取数据文件。往赛季数据不定期更新，当前赛季2小时更新1次。数据文件为zip格式，内容存放于data.txt文件当中。每个文件包含一个联赛一个赛季的全部比赛数据，包括：赛事、赛事统计、球员、球员统计等。通过本接口的数据同步，可以实现比分站点的基本要求，并获得全部数据的基础数据部分，对于联赛、球员等数据的详细数据需求，
请求参数
参数名
类型
描述
必填
tournament_id
int
（选填）联赛id，仅输出该联赛的数据
必填
sport_id
int
（选填）运动类型id
必填
t
String
时间戳,当前时间前后2小时内，格式 yyyyMMddHH
必填
code
String
用户编号，系统分配给用户的32位编码
必填
auth_token
String
校验参数，md5(md5(username)+secreteKey+code+时间戳)
必填
响应参数
参数名
类型
描述
必填
id
int
更新文件id；不会重复，可作为唯一标志；示例：29103
必填
path
string
更新文件路径；包名格式为 联赛id_赛季id_生成时间:；示例：http://xxx.xxx.com/history/1287_0_1605823022629.zip
必填
updatetime
date
更新时间；示例：2020-11-20 05:57:02.000
必填
说明 / 示例
data.txt数据结构
参数名
类型
描述
必填
id
int
联赛id
必填
cn_alias
string
联赛中文别名
必填
cn_name
string
联赛中文名
必填
current_season_id
int
联赛当前赛季id （可以忽略，由于历史数据包存在本id与联赛实际当前赛季id不一致情况，建议使用“联赛列表”接口实时获取最新的赛季id）
必填
en_alias
string
联赛英文别名
必填
en_name
string
联赛英文名
必填
sport_id
int
运动类型1足球2篮球3棒球5网球
必填
logo_url
string
Logo路径
必填
type
int
类别，1联赛，2杯赛
必填
period_type
int
比赛分段类型: 足球: 2上下半场 篮球:4四小节 2上下半场 网球：3/5盘数 棒球：9盘数
必填
category_id
int
分类id
必填
category_cn_name
string
分类中文名
必填
category_continent
string
分类所属大洲
可选
id
int
赛季id
必填
year
String
年份
必填
start
date
开始时间
必填
end
date
结束时间
必填
has_player_statistics
int
是否有球员统计数据（球员赛季汇总、球队赛季汇总） 0没有 1有
必填
has_ranking
int
是否有球队积分榜 0没有 1有
必填
has_promotion_chart
int
是否有晋级图
必填
cn_alias
string
分组中文别名
必填
cn_name
string
分组中文名
必填
en_alias
string
分组英文别名
必填
en_name
string
分组英文名
必填
id
int
分组id
必填
type
int
类别，1积分赛，2淘汰赛
必填
id
int
榜单id
必填
cn_name
string
中文名
必填
en_name
string
英文名
必填
group_id
int
所属分组id
必填
id
int
晋级图id
必填
cn_name
string
中文名
必填
en_name
string
英文名
必填
group_id
int
所属分组id
必填
id
int
系列赛id
必填
begin_time
date
系列赛开始时间
必填
team1_id
int
队伍1 id
必填
team2_id
int
队伍2 id
必填
team1_score
int
队伍1得分
必填
team2_score
int
队伍2得分
必填
team1_comefrom
int
队伍1从哪个系列赛来的 （仅对双败淘汰赛）
可选
team2_comefrom
int
队伍2从哪个系列赛来的 （仅对双败淘汰赛）
可选
match_ids
string
该系列赛包含的比赛id列表，多个比赛id用逗号隔开
必填
round_order
int
轮次序号，从右边数，1开始
必填
line_order
int
纵向序号，从上至下 1开始
必填
double_elimination_group
int
双败淘汰赛组别：1.胜者组 2.败者组 3.决赛
必填
status
int
状态：0占位 1未开始 2进行中 3完成
必填
winner
int
胜利者：1队伍1， 2队伍
必填
round_descript
string
轮次文字描述
必填
parent_id
int
上一级系列赛的id
可选
team1_score_full
string
队伍1得分,格式 ： 普通进球得分（点球得分）
必填
team2_score_full
string
队伍2得分,格式 ： 普通进球得分（点球得分）
必填
id
int
球队id
必填
cn_name
string
球队中文名
必填
cn_alias
string
球队中文别名
必填
en_name
string
球队英文名
必填
en_alias
string
球队英文别称
必填
country_id
int
所在国家id
必填
coach_id
int
教练id
必填
coach_en_name
string
教练英文名
必填
coach_cn_name
string
教练中文名
必填
stadium_id
int
场馆id
必填
stadium_cn_name
string
场馆中文名
必填
stadium_en_name
string
场馆英文名
必填
city_id
int
城市id
必填
city_cn_name
string
城市中文名
必填
city_en_name
string
城市英文名
必填
establish_date
date
建立日期
必填
logo_url
string
球队logo
必填
logo_url2
string
球队的logo2，一般是作为网球双打的第二个球员头像
必填
is_country
int
是否国家队：0 否 1是
必填
team_id
int
所在球队id
必填
id
int
球员id
必填
cn_alias
string
中文别名
必填
cn_name
string
中文名
必填
en_alias
string
英文别名
必填
en_name
string
英文名
必填
country_id
int
国家id
可选
nationality
string
国籍中文名称
可选
position
string
打球位置
可选
position_id
int
打球位置id
可选
shirt_number
int
球衣号
必填
preferred_foot
string
惯用脚
必填
birthdate
date
生日
必填
height
int
身高cm
必填
weight
int
体重kg
必填
pic_url
string
头像图片
必填
sport_id
int
赛事类型ID：1足球2篮球3棒球5网球
必填
is_foreign_player
int
是否外国球员(相对球队)：0否1是
必填
is_national_player
int
是否国家队员(球员国籍国) ：0否1是
必填
season_id
int
赛季id
必填
tournament_id
int
所属联赛id
必填
player_id
int
球员id
必填
team_id
int
球队id
必填
type_id
int
统计类型id，参照（常用数据字典：技术统计类型）
必填
type_value
int
统计值
必填
range
int
统计范围：0全部 1主场 2客场
必填
season_id
int
赛季id
必填
tournament_id
int
所属联赛id
必填
team_id
int
球队id
必填
type_id
int
统计类型id，参照（常用数据字典：技术统计类型）
必填
type_value
int
统计值
必填
range
int
统计范围：0全部 1主场 2客场
必填
matchs
array
赛事列表；本数据结构请参照“比赛详情”接口描述
必填