beta GetEvents - Saba-sports/OddsDirectAPI_CN GitHub Wiki

此API用于获取赛事相关信息包含部分盘口信息

Request

GET  /sports/{version}/GetEvents?query=$filter=sporttype eq 1&includeMarkets=$filter=bettype eq 128&language=cs
Accept: application/json
Accept-Encoding: br, gzip, deflate
X-Forwarded-For: client ip (如果通过代理使用API需要额外带入)
Authorization: Bearer {JWT token}
Parameter Description
query 使用Odata指定特定格式的查询
from 指定赛事开始日期,可以单独输入
until 指定赛事结束日期,可以单独输入
language 指定欲回应的数据语系,请参阅Language Table
includeMarkets 此参数仅在 /GetEvents 中使用,指定是否有必要回传market讯息。
如果includeMarkets未指定,则默认回传。
includeMarkets = $filter=bettype eq 128; 仅筛选指定条件Market信息。
includeMarkets = none; 将不回传Market信息。

Response

{    
    "events": Event[],
    "markets": Market[] | null 
} 
Name Format Description
events Event array 赛事信息列表
markets Market array 盘口信息列表

Event

{
	"sportType": int,
	"sportName": string,
	"leagueId": int,
	"leagueName": string,
	"eventId": int,
	"eventCode": string,
	"eventStatus": string,
	"isMainMarket": bool,
	"kickOffTime": DateTime,
	"globalShowTime": DateTime,
	"countryCode": string,
	"gameSession": int,
	"parentId": int,
	"isTest": bool,
	"isLive": bool,
	"isParlay": bool,
	"isCashout": bool,
	"isVirtualEvent": bool,
	"hasLiveMarket": bool,
	"marketCount": int,
	"marketCategories": int[],
	"streamingOption ": int,
	"channelCode ": string,
	"teamInfo": TeamInfo,
	"gameInfo": GameInfo,
	"soccerInfo": SoccerInfo | null,
	"tennisInfo": TennisInfo | null,
	"beachVolleyBallInfo": BeachVolleyBallInfo | null,
	"eSportInfo": ESportInfo | null,
}
Name Format Description Queryable Query Example
sportType int 体育项目ID Yes $filter=sporttype eq 1
sportName string 体育项目名称 Yes $filter=sportname eq 'Soccer'
leagueId int 联赛ID Yes $filter=leagueid eq 56038
leagueName string 联赛名称 Yes $filter=leaguename eq '*UEFA CHAMPIONS LEAGUE' or $filter=contains(leaguename,'NBA')
eventId int 赛事ID Yes $filter=eventid eq 38255274
eventCode string 赛事代码 No
eventStatus string 赛事状态
running/ closed/ postponed/ deleted
Yes $filter=eventStatus eq 'running'
isMainMarket bool 是否为主要盘口 Yes $filter=ismainmarket eq true
kickOffTime DateTime 系统开赛时间 (时区GMT+0) No
globalShowTime DateTime 开赛时间 (时区GMT+0) No
countryCode string 联赛国别代码 No
gameSession int 赛事比赛有多少节 No
parentId int 该赛事的母赛事ID No
isTest bool 是否为测试赛事 No
isLive bool 是否为滚球赛事 Yes $filter=islive eq true
isParlay bool 是否为串关赛事 Yes $filter=isparlay eq true
isCashout bool 赛事是否支持实时兑现 Yes $filter=iscashout eq true
isVirtualEvent bool 是否为虚拟赛事 Yes $filter=isvirtualevent eq true
hasLiveMarket bool 是否有滚球盘口 No
marketCount int 该赛事的所有盘口数量 No
marketCategories int[] 该赛事的所有盘口投注类型
0: None (主要)
1: FullTime (全场)
2: Half (半场)
3: Corners (角球)/Bookings (罚牌)
4: Intervals (区间)
5: Specials (特别产品)
6: Players (选手)
7: FastMarket (快速盘口)
8: Quarter (节)
9: ExtraTime (加时)
10: Penalty (点球)
11-19: E-Sports Map 1-9 (电子竞技适用 – 地图 1~9)
No
streamingOption int 视频ID Yes $filter=streamingOption eq 131072
channelCode string 视频代码 Yes $filter=channelCode ne null
teamInfo TeamInfo 团队相关信息 No
gameInfo GameInfo 球赛相关信息 No
soccerInfo SoccerInfo 足球相关信息 No
tennisInfo TennisInfo 网球相关信息 No
beachVolleyBallInfo BeachVolleyBallInfo 沙滩排球相关信息 No
eSportInfo ESportInfo 电子竞技相关信息 No

TeamInfo

{
	"homeId": int,
	"homeName": string,
	"homeIconUrl": string
	"awayId": int,
	"awayName": string,
	"awayIconUrl": string
}
Name Format Description Queryable Query Example
homeId int 主队ID Yes $filter=homeId eq 17892
homeName string 主队名称 Yes $filter=contains(homename,'Field')
homeIconUrl string 主队队徽URL, 如果图片不存在请使用预设主队队徽URL
{domain}/TeamImg/team_flag_home.png
No -
awayId int 客队ID Yes $filter=awayid eq 714227
awayName string 客队名称 Yes $filter=contains(awayname,'Lakers')
awayIconUrl string 客队队徽URL, 如果图片不存在请使用预设客队队徽URL
{domain}/TeamImg/team_flag_away.png
No -

GameInfo

{
	"livePeriod": byte,
	"clockDirection": string,
	"seconds": int,
	"isNeutral": bool,
	"isHt": bool,
	"isBreak": bool,
	"isClosed": bool,
	"inJuryTime": byte,
	"delayLive": bool,
	"gameStatus" byte,
	"inPlayTime": string,
	"liveHomeScore": int,
	"liveAwayScore": int
}
Name Format Description Queryable Query Example
livePeriod byte 目前进行到第几节
如果值为 0,则前端不显示时间。这意味着比赛正处于特殊时期。
No
clockDirection string 赛事时间计算方式
inc:从0开始计数到赛事结束
dec:从特定值开始计数到0
No
seconds int 当前赛事时间以秒为单位 No
isNeutral bool 是否为中立场 No
isHt bool 是否为中场休息 No
isBreak bool 赛事是否中断(休息时间) No
isClosed bool 赛事是否关闭 No
inJuryTime byte 伤停时间 No
delayLive bool 赛事是否延迟 No
gameStatus byte 球赛状态
1=PRC(有可能被判红牌)
2=PPen(有可能被判点球)
3=VAR(视频助理裁判)
4=Penalty(点球)
5=Injury(球员受伤)
6=Sudden Death(骤死赛)
No
inPlayTime string 目前赛事时间 No
liveHomeScore int 主队滚球分数 No
liveAwayScore int 客队滚球分数 No

SoccerInfo

{
	"homeRedCard":byte,
	"awayRedCard":byte,
	"homeYellowCard":byte,
	"awayYellowCard":byte
}
Name Format Description Queryable Query Example
homeRedCard byte 主场红牌数 No
awayRedCard byte 客场红牌数 No
homeYellowCard byte 主场黄牌数 No
awayYellowCard byte 客场黄牌数 No

TennisInfo

{
	"homeGameScore": int[],
	"awayGameScore": int[],
	"homePointScore": string,
	"awayPointScore": string,
	"currentSet": int,
	"currentServe": int
}
Name Format Description Queryable Query Example
homeGameScore int[] 主队每盘获得局数 No
awayGameScore int[] 客队每盘获得局数 No
homePointScore string 主队目前局数比分 No
awayPointScore string 客队目前局数比分 No
currentSet int 目前盘数 No
currentServe int 目前发球方 No

BeachVolleyBallInfo

{
	"homeGameScore": int[],
	"awayGameScore": int[],
	"currentSet": int,
	"currentServe": int,
	"playerInjury": int,
	"isRain" bool`
}
Name Format Description Queryable Query Example
homeGameScore int[] 主队每盘获得局数 No
awayGameScore int[] 客队每盘获得局数 No
currentSet int 目前盘数 No
currentServe int 目前发球方 No
playerInjury int 哪支队伍有人受伤
0=no one(无), 1=home(主队), 2=away(客队), 3=both(两队)
No
isRain bool 是否为雨天 No

ESportInfo

{
	"bestOfMap": int,
	"isStartingSoon": bool,
	"moveBO3Down": bool,
	"overTimeSession": int,
	"leagueGroup": string,
	"leagueGroupId": int
}
Name Format Description Queryable Query Example
bestOfMap int Best Of Map标识会打几个地图 No
isStartingSoon bool 是否即将开赛 No
moveBO3Down bool 控制是否显示网页的旗帜 No
overTimeSession int 联赛信息
1 → Dota2 ; 2 → LOL ; 3 → CS2 ; 4 → KOG ; 99 → Others
No
leagueGroup string 电子竞技联赛名称 No
leagueGroupId int 电子竞技联赛ID No

Market

盘口相关信息请参阅GetMarkets

⚠️ **GitHub.com Fallback** ⚠️