比赛详情
GET
/datashare/matchInfo
接口描述
返回某一场比赛详情数据。
请参数
参数名
类型
描述
必填
id
int
比赛id
必填
t
String
时间戳,当前时间前后2小时内，格式 yyyyMMddHH
必填
code
String
用户编号，系统分配给用户的32位编码
必填
auth_token
String
校验参数，md5(md5(username)+secreteKey+code+时间戳)
必填
响应参数
参数名
类型
描述
必填
away_formation
string
客队首发阵型；示例：4-4-2；参照 (FAQ：足球首发阵容图的显示）
可选
away_team_half_time_score
int
客队半场得分；示例：1
可选
away_team_id
int
客队id；示例：875
必填
away_team_name
string
客队中文名，冗余数据，更新应以球队信息内容为准；示例：莫斯科火车头
必填
away_team_en_name
String
客队英文名，冗余数据，更新应以球队信息内容为准；
必填
away_team_normal_time_score
int
示例：2
可选
away_team_score
int
示例：2
可选
match_time
datetime
比赛计划开始时间；示例：2020-10-22 00:55:00.000
必填
start_time
datetime
比赛实际开始时间
可选
end_time
datetime
比赛结束时间；示例：2020-10-22 02:45:50.000
可选
current_period_start_time
datetime
当前状态开始时间；示例：2020-10-22 02:45:50.000
可选
group_id
int
赛程分组id；示例：192
可选
has_event
int
是否有主要事件：0没有 1有；示例：1
必填
has_eventphase
int
是否有事件文字直播：0没有 1有；示例：1
必填
has_injury
int
是否有伤停信息：0没有 1有；示例：0
必填
has_lineup
int
是否有阵容：0无 1正式阵容 2阵容预告；示例：1
必填
has_liveodds
int
是否有滚球百家盘：0没有 1有；示例：1
必填
has_news
int
是否有新闻资讯：0没有 1有；示例：1
必填
has_phase
int
是否有文字直播：0没有 1有；示例：0
必填
has_player_statistics
int
是否有球员统计数据：0没有 1有；示例：1
必填
has_preodds
int
是否有赛前百家盘：0没有 1有；示例：1
必填
has_statistics
int
是否有比赛队伍统计数据：0没有 1有；示例：1
必填
home_formation
string
主队首发阵型；示例：4-4-2；参照 （FAQ：足球首发阵容图的显示）
可选
home_team_half_time_score
int
示例：1
可选
home_team_id
int
主队id；示例：739
必填
home_team_name
String
主队中文名字，冗余数据；示例：萨尔茨堡红牛
必填
home_team_en_name
String
主队英文名字，冗余数据；
必填
home_team_normal_time_score
int
主队90分钟得分；示例：2
可选
home_team_score
int
主队全场总得分；示例：2
可选
id
int
比赛id；示例：2653863
必填
is_visible
string
是否可见：0隐藏 1可见；示例：1
必填
lmt_mode
int
是否有动画：0没有 1有 ；示例：1
必填
neutral
int
是否中立场：0否 1是；示例：0
必填
referees
array
裁判团列表
可选
round
string
轮次中文名；示例：组A
必填
round_id
int
轮次id；示例：151
必填
round_type
string
轮次类型中文名；示例：分组赛
必填
round_type_id
int
轮次类型id；示例：2
必填
season
string
赛季名；示例：2020-2021
必填
season_id
int
赛季id；示例：232695
必填
sidelined
array
缺阵球员列表
必填
sport_id
int
赛事运动类型id；示例：1
必填
stadium_cn_name
string
比赛场馆中文名；示例：红牛竞技场
可选
stadium_en_name
string
比赛场馆英文名；示例：Red Bull Arena
可选
stadium_id
int
比赛场馆id；示例：67
可选
status
int
比赛状态；1未开始 2进行中 3已结束 4取消
必填
status_code
int
比赛子状态码，参照常用数据字典；示例：100
必填
status_name
string
比赛状态名字，参照常用数据字典；示例：完场
必填
time_played
int
足球比赛已进行时间（秒）；示例：5656
可选
time_remaining
int
篮球每节比赛剩余时间（秒）；示例：0
可选
time_running
int
比赛时钟是否计时中：1计时中 0暂停计时；示例：0
可选
time_update
datetime
比赛进行时间更新时间；示例：2020-10-25 00:46:22.000；比赛进行时间显示方式请参看FAQ 《比赛时间计算及展示方式》
可选
tournament_id
int
联赛id；示例：2
必填
update_timestamp
long
更新时间戳；示例：1607924660
必填
weather
string
天气简述；示例：Some cloud
可选
weather_desc
string
天气详细描述，使用方式请参照 （FAQ：天气详情字段描述）；示例：[{"V":"+11°C","K":9},{"V":"85","K":27},{"V":"762","K":25},{"V":"2","K":23},{"V":"SE wind, m/s","K":24},{"V":"Some cloud","K":21}]
可选
winner
int
获胜队伍：0未知 1主 2客3平；示例：3
必填
merge_id
int
赛事合并后的新的赛事id，部分比赛由于与已有比赛重复而被取消，当被取消比赛含有merge_id时，表示该比赛已迁移至赛事id为merge_id的比赛。
可选
previous_match_id
int
双回合淘汰赛，上一回合比赛的比赛id
可选
aggregate_winner
int
双回合淘汰赛的胜出队伍： 1主队，2客队
可选
cup_round_match_number
int
淘汰赛中的回合序号， 1：首回合 2：第二回合 (非淘汰赛没有本字段)
可选
cup_round_number_of_matches
int
淘汰赛中的回合数， 1.单回合淘汰 2双回合淘汰 (非淘汰赛没有本字段)
可选
attendance
int
球场观众人数
可选
distance
int
两球队间的距离（公里）
可选
side
int
当前主攻队伍，仅对棒球和网球有意义：1主 2客； 网球：发球方 棒球：击球方
可选
game_score
string
当局比分，仅对网球有意义；示例：30:15
可选
referee_id
int
主裁判id
可选
referee_cn_name
string
主裁判中文名
可选
referee_en_name
string
主裁判英文名
可选
toss_win
int
挑边获胜者：主1 客2 (当前仅支持板球)
可选
toss_decision
String
挑边选择：Batting/Bowling（ (当前仅支持板球)）
可选
is_pending
int
比赛时间是否待定，0否 1是。通常在杯赛初期赛程的时候由于比赛时间不确定该状态为1
必填
comment
String
比赛特殊情况的注释，如：30分钟每节的（足球比赛）、暴雨导致比赛中断等
可选
time_length
比赛常规每节时长(分钟)。足球上下半场各多少分钟，篮球每节分钟数
可选
time_ot_length
每节加时段时长(分钟)，足球加时上下半场各多少分钟，篮球加时每节多少分钟
可选
period
int
比赛局数: 网球、棒球 、电竞等（对于比赛局数不固定的联赛，以此为准）
可选
goal_type
int
进球类型，1进球，2乌龙球，3头球，4点球，5点球大战；示例：1
可选
id
int
事件id；示例：16473210
必填
injury_time
int
补时阶段的第几分钟（分钟）；示例：0
可选
player_id
int
关联球员id，表示换入或进球球员id。若为0则表示无法关联球员；示例：210723
可选
player_name
string
球员名字，若无球员id，则直接使用该名字；若具有球衣号，则球员名字显示为”球衣号#球员名字”；示例：多米尼克-索博斯洛伊
可选
player_pic_url
string
球员头像；示例：_file/players/20190314012738677_150x150.png
可选
player_id2
int
关联球员id2，表示换出或进球助攻球员id，若为0则表示无法关联球员
可选
player_name2
string
球员名字2，若无球员id，则直接使用该名字。 若具有球衣号，则球员名字显示为”球衣号#球员名字”
可选
player_pic_url2
string
球员头像2
可选
sort
int
事件顺序号，事件发生的顺序；示例：24
必填
team
int
所属球队1主队 2客队；示例：1
必填
time
int
事件发生时间(比赛进行的秒数)；示例：858
必填
type_id
int
事件类型；示例：30 ；参看《常用数据字典》中 事件类型 对照表
必填
type_name
string
事件名称；示例：角球
必填
x
string
球场x坐标；示例：95
可选
y
string
球场y坐标；示例：90
可选
scores
string
事件发生后比分；示例：1-1
可选
confirm_result
int
VAR视频裁判结果（0.不通过;1.通过 ）仅VAR事件提供
可选
substitute
int
是否替补席球员的事件 0否 1是
必填
status_code
int
比赛状态，仅足篮球提供。参看《常用数据字典》中 status_code对照表
必填
time_remain
int
当前赛节剩余比赛时间（秒），仅蓝球提供
必填
match_id
string
比赛id；示例：2653863
必填
team1
string
主队得分；示例：2
必填
team2
string
客队得分；示例：2
必填
type
string
比分类型，参照 常用数据字典的《比分类型type对照表》
必填
update_time
datetime
更新时间；示例：2020-10-22 02:25:26.000
必填
period
string
比赛阶段：0全场；示例：0
必填
team1
float
主队数据；示例：54.0
必填
team2
float
客队数据；示例：46.0
必填
type_cn_name
string
统计类型中文名；示例：控球率
必填
type_en_name
string
统计类型英文名；示例：BallPossession
必填
type_id
int
统计类型id，参照 （常见数据字典：赛事统计数据类型表）；示例：1
必填
period
string
比赛阶段：1足球上半场(篮球第一节) 2足球下半场(第二节) 3足球加时（篮球第三节） 4篮球第四节 5篮球加时；示例：1
必填
team1
float
主队数据；示例：52.0
必填
team2
float
客队数据；示例：48.0
必填
type_cn_name
string
统计类型中文名；示例：控球率
必填
type_en_name
string
统计类型英文名；示例：BallPossession
必填
type_id
int
统计类型id，参照 （常见数据字典：赛事统计数据类型表）；示例：1
必填
matchpos
string
球员在场上角色的名字；示例：门将
必填
matchpos_id
int
球员在场上角色的id ；示例：101
必填
player_id
int
球员id， id为0或者负数时是无法关联到具体球员的，阵容列表上请直接使用play_name显示其名字；示例：3414
必填
player_name
string
球员名；示例： 亚历山大-沃尔克
必填
player_pic_url
string
球员头像；示例：_file/players/20190314001223239_150x150.png
必填
position
int
球员位置；足球参照 （FAQ：足球首发阵容图的显示），其它赛种没有明确意义；示例：0
必填
shirt_number
int
球衣号码；示例：33
必填
substitute
int
是否替补：1是0否；示例：1
必填
team_id
int
球队id；示例：739
必填
captain
int
是否队长：1是 0否
必填
player_id
int
球员id；示例：3414
必填
team_id
int
球队id；示例：739
必填
type_id
int
统计类型id （常见数据字典：技术统计类型表）示例：1202
必填
type_value
float
统计值,整数或浮点；示例：0, 1.1
必填
team_id
int
球队id
必填
player_id
int
球员id， id为0或者负数时是无法关联到具体球员的，阵容列表上请直接使用play_name显示其名字
必填
player_name
string
球员名
必填
position
string
球员位置
可选
shirt_number
int
球衣号码
必填
player_pic_url
string
球员头像
必填
reason
string
缺阵原因
必填
describe
string
原因描述：病因/红牌
必填
describe_id
int
原因描述id
必填
referee_id
int
裁判id
必填
referee_name
string
裁判中文名
必填
type
int
类型：1主裁判 2助理 3第四官员
必填
country_id
int
国籍国家id
必填
country_name
string
国家中文名
必填
redCardsPerGame
float
场均红牌数
必填
yellowCardsPerGame
float
场均黄牌数
必填
id
int
id
必填
time
string
时间，足球：进行分钟数，篮球：当前节剩余时间(分:秒)
必填
cn_text
string
中文文字内容
必填
en_text
string
英文文字内容
必填
event_id
int
事件id，对应events的id，本字段属于可选字段
必填
period
int
比赛阶段：第几赛节 当前仅篮球提供该字段，并不保证全部比赛都有该字段
必填
team
int
所属球队：0公共，1主队，2客队 ；当前仅篮球有该字段，并不保证全部比赛都有该字段
必填
score
string
文字直播时的比赛比分；示例：101-109
必填
team_id
球队id；示例：739
必填
type_id
统计类型id （常见数据字典：技术统计类型表）示例：3202
必填
type_value
统计值；示例：0
必填
period
比赛阶段：1第一节 2第二节 3第三节 4第四节 5第五节 示例：1
必填
score_events
array
比赛比分事件，记录比分变化过程（仅网球、羽毛球、乒乓球提供，不同比赛的数据结构有差异，请参看下面说明）
可选
说明 / 示例
网球--特别字段说明
参数名
类型
描述
必填
set
int
第几盘（如：1，2，3）
必填
game
int
第几局
必填
homeScore
int
主队得分（局结束后局分，该局进行中的时候没有该值）
可选
awayScore
int
客队得分（局结束后局分，该局进行中的时候没有该值）
可选
scoring
int
得分队伍：1主队 2客队 （该局进行中的时候没有该值）
可选
serving
int
发球队伍：1主队 2客队
必填