GetPromotions - Saba-sports/OddsDirectAPI_CN GitHub Wiki

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

Request

GET  /sports/{version}/GetPromotions
Accept: application/json
Accept-Encoding: br, gzip, deflate
X-Forwarded-For: client ip (如果通过代理使用API需要额外带入)
Authorization: Bearer {JWT token}
Parameter Description
query 使用Odata指定特定格式的查询
language 指定欲回应的数据语系，请参阅Language Table
includeMarkets 指定是否有必要回传market讯息。
如果includeMarkets未指定，则默认回传。
includeMarkets = $filter=bettype eq 128; 仅筛选指定条件Market信息。
includeMarkets = none; 将不回传Market信息。

Odata 额外可选参数

Parameter Description Query Example
currency 指定币别 $filter=currency eq 51

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,
	"isVirtualEvent": bool,
	"hasLiveMarket": bool,
	"marketCount": int,
	"marketCategories": int[],
	"streamingOption ": int,
	"channelCode ": string,
	"teamInfo": TeamInfo,//Described in a separate table blow.
	"gameInfo": GameInfo,//Described in a separate table blow.
	"soccerInfo": SoccerInfo | null,//Described in a separate table blow.
	"tennisInfo": TennisInfo | null,//Described in a separate table blow.
	"eSportInfo": ESportInfo | null,//Described in a separate table blow.
}
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		 No —
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[] 该赛事的所有盘口投注类型 No —
streamingOption int 视频ID No —
channelCode string 视频代码 No —
teamInfo TeamInfo 团队相关信息 No —
gameInfo GameInfo 球赛相关信息 No —
soccerInfo SoccerInfo 足球相关信息 No —
tennisInfo TennisInfo 网球相关信息 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,
	"isNeutral": bool,
	"isHt": bool,
	"isBreak": bool,
	"isClosed": bool,
	"inJuryTime": int,
	"delayLive": bool,
	"gameStatus" byte,
	"inPlayTime": string,
	"liveHomeScore": int,
	"liveAwayScore": int
}
Name Format Description Queryable Query Example
livePeriod byte 目前进行到第几节 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 —

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 S是否即将开赛 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

{
    "sportType": int,
	"eventId": int,
	"betType": int,
	"betTypeName": string,
	"sportType": int,
	"marketId": int,
	"maxBet": decimal,
	"isLive": bool,
	"marketStatus": string,
	"gameMap": short?,
	"gameRound": short?,
	"resourceId": string,
	"category": int,
	"sort": int,
	"combo": int,
	"selections": SelectionInfo[]
}
Name Format Description Queryable Query Example
sportType int 体育项目ID Yes $filter=sporttype eq 1
eventId int 赛事ID Yes $filter=eventid eq 38255274
betType int 投注类型 Yes $filter=bettype eq 128
betTypeName string 投注类型名称 No —
marketId int 盘口ID Yes $filter=marketed eq 274175476
maxBet decimal 最大投注限额 No —
isLive bool 是否为滚球赛事 Yes $filter=islive eq true
marketStatus string 盘口状态
running / suspend / closePrice / closed		 No —
gameMap short? [电子竞技专用]游戏地图
when sport type = 43 and bet type in 9001-9100		 No —
gameRound short? [电子竞技专用] 游戏回合
when sport type = 43 and bet type = 9007, 9011, 9027, 9062, 9068, 9070, 9071, 9072, 9073, 9077		 No —
resourceId string 资源 ID No —
category int 投注类型分类
0: None (主要) ;
1: FullTime (全场) ;
2: Half (半场) ;
3: Corners (角球) ;
4: Bookings (罚牌) ;
5: Intervals (区间) ;
6: Specials (特别产品) ;
7: Players (选手) ;
8: ExtraTime (加时) ;
9: FastMarket (快速盘口) ;
10: Quarter (节) ;
11-19: E-Sports Map 1-9		 No —
sort int 排序
when bet type=1,3,7,8 and have multiple point.		 No —
combo int 赛事串关限制 No —
selections SelectionInfo[] 盘口赔率项目列表 No —

SelectionInfo

[
	{
	    "key": string,
	    "keyName": string,
	    "point": decimal?,
	    "point2": decimal?,
	    "oddsPrice": OddsPriceInfo
	}
]
Name Format Description Queryable Query Example
key string 投注类型选项 No —
keyName string 投注类型选项名称 No —
point decimal? 球头 No —
point2 decimal? 球头2
Only for bet type=646;
point=HDP, point2=OU		 No —
oddsPrice OddsPriceInfo 赔率相关信息 No —
OddsPriceInfo
{
	"parlayPrice": decimal,
	"malayPrice": decimal,
	"hongKongPrice": decimal,
	"decimalPrice": decimal,
	"indoPrice": decimal,
	"americanPrice": decimal
}
Name Format Description Queryable Query Example
parlayPrice decimal 串关赔率 No —
malayPrice decimal 马来盘赔率 No —
hongKongPrice decimal 香港盘赔率 No —
decimalPrice decimal 欧洲盘赔率 No —
indoPrice decimal 印度尼西亚盘赔率 No —
americanPrice decimal 美国盘赔率 No —

© 2022 S A B A S P O R T S

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