1. 体育赛事

1.1 内容采集定义

错误码定义

HTTP错误码	业务错误码	错误信息	备注
200	0	OK	成功
400	1	Invalid parameter	无效参数
400	2	Incorrect signature	签名错误
400	3	Too many parameters	参数过多
400	4	Unsupported signature method	不支持此签名方式
400	5	Invalid/Used timestamp parameter	时间戳无效
400	6	Unsupported open api	不支持此接口
401	12	Session key invalid or no longer valid	会话密钥无效
403	31	Forbidden	信息校验失败
400	32	Data parse error	数据解析出错
400	80	Request Timeout	请求超时
500	101	Unknown error	未知错误
500	102	Server internal error	服务器错误
500	103	Service temporarily unavailable	服务暂不可用

1.2 队伍信息获取

1.2.1 基本信息

方法：POST

URL：/sports/teams

说明：

1.2.2 请求头域

暂无成员

1.2.3 请求消息

名称	是否必选	类型	描述
requestBody	是	SportsTeamInfoReq	请求消息

1.2.4 响应消息

响应码	响应体类型	描述
200	SportsTeamInfoRsp	查询成功，返回查询结果。

1.3 赛事信息获取

1.3.1 基本信息

方法：POST

URL：/sports/schedules

说明：

1.3.2 请求头域

暂无成员

1.3.3 请求消息

名称	是否必选	类型	描述
requestBody	是	SportsScheduleInfo	请求消息

1.3.4 响应消息

响应码	响应体类型	描述
200	SportsScheduleInfoRsp	查询成功，返回查询结果。

1.4 基本类型结构

1.4.1 LeagueId

联赛ID：NBA-NBA， UK_EPL-英超， ITA_SERIEA-意甲， ESP_LALIGA-西甲， GEM_BUNDESLIGA-德甲， FRA_L1-法甲， CN_CBA-CBA， CN_CSL-中超，UEFA_CL-欧冠，UEFA_EL-欧联。

类型	取值范围
string	枚举值： NBA， UK_EPL， ITA_SERIEA， ESP_LALIGA， GEM_BUNDESLIGA， FRA_L1， CN_CBA， CN_CSL

1.5 对象类型结构

1.5.1 SportsTeamInfoReq

指定联赛ID列表查询

成员名称	描述	是否必选	类型	取值范围
leagueIds	联赛ID，查询多个用英文逗号分隔。	否	LeagueId[]	最大Item数： 32

1.5.2 SportsTeamInfoRsp

成员名称	描述	是否必选	类型	取值范围
data		是	SportsTeamInfoItem[]	最大Item数： 32

1.5.3 SportsTeamInfoItem

成员名称	描述	是否必选	类型	取值范围
teamId	球队Id	是	string	最大长度： 32
teamName	球队名称	是	string	最大长度： 64
leagueId	联赛ID：NBA-NBA， UK_EPL-英超， ITA_SERIEA-意甲， ESP_LALIGA-西甲， GEM_BUNDESLIGA-德甲， FRA_L1-法甲， CN_CBA-CBA， CN_CSL-中超，UEFA_CL-欧冠，UEFA_EL-欧联	是	string （LeagueId）	/
leagueName	联赛名称	是	string	最大长度： 32
alias	球队别名	否	string	最大长度： 64
logo	球队logo信息	是	Image	/
hot	热度： 0-非热门队伍；1-热门队伍	是	int	枚举值： 0， 1
desc	球队简要描述信息	否	string	最大长度： 512
homePage	球队主页跳转Link，最大长度128字节	否	Interaction	/
chiefCoach	主教练	否	string	最大长度： 64

1.5.4 SportsScheduleInfo

SportsScheduleInfo 请求查询方式包含：

（1）指定赛事ID，开始时间、结束时间查询联赛赛程。

（2）指定开始时间、结束时间，查询时间段内所有已知的联赛赛程。

成员名称	描述	是否必选	类型	取值范围
leagueId	联赛ID：NBA-NBA， UK_EPL-英超， ITA_SERIEA-意甲， ESP_LALIGA-西甲， GEM_BUNDESLIGA-德甲， FRA_L1-法甲， CN_CBA-CBA， CN_CSL-中超，UEFA_CL-欧冠，UEFA_EL-欧联	否	string （LeagueId）
beginDate	查询开始时间查询开始时间（日期，格式2018-09-09）	否	string	最大长度： 20
endDate	查询结束时间查询结束时间（日期，格式2018-09-09）	否	string	最大长度： 20

1.5.5 SportsScheduleInfoRsp

成员名称	描述	是否必选	类型	取值范围
data		是	SportsScheduleInfoItem[]	最大Item数： 256

1.5.6 SportsScheduleInfoItem

成员名称	描述	是否必选	类型	取值范围
matchId	赛事Id	是	string	最大长度： 32
leagueId	联赛ID：NBA-NBA， UK_EPL-英超， ITA_SERIEA-意甲， ESP_LALIGA-西甲， GEM_BUNDESLIGA-德甲， FRA_L1-法甲， CN_CBA-CBA， CN_CSL-中超，UEFA_CL-欧冠，UEFA_EL-欧联	是	string （LeagueId）	/
leagueName	联赛名称	是	string	最大长度： 32
pubTime	体育赛程发布时间	是	string	最大长度： 20
season	比赛赛季，格式为2017-2018。	是	string	最大长度： 32
round	轮次，如第一轮。	是	string	最大长度： 32
beginTime	比赛开始时间	是	string	最大长度： 20
status	状态 1：未开始；2：进行在；3：已结束。	是	string	最大长度： 8
process	当前比赛进度，status为2（进行中）的比赛有效。如“第2节”。	是	string	最大长度： 32
gameTime	比赛进行的时间，status为2（进行中）的比赛有效。	是	string	最大长度： 32
matchType	比赛类型，如常规赛、季后赛等。	是	string	最大长度： 32
informations	比赛相关资讯信息	是	SportsScheduleInformationItem[]	/
hot	热度 0-非热门；1-热门。	是	int	枚举值： 0，1
homeTeam	主队信息	否	SportsScheduleTeam	/
awayTeam	客队信息	否	SportsScheduleTeam	/

1.5.7 SportsScheduleInformationItem

比赛相关资讯信息

成员名称	描述	是否必选	类型	取值范围
title	比赛相关资讯标题	是	string	最大长度： 128
infoType	比赛资讯类型：TEXTLIVE， VIDEOLIVE， IMAGE	是	string	最大长度： 16，枚举值： TEXTLIVE， VIDEOLIVE， IMAGE
link	/	否	Interaction	/
image	单个图片信息	否	Image	/

1.5.8 SportsScheduleTeam

赛事球队信息

成员名称	描述	是否必选	类型	取值范围
teamId	球队ID	是	string	最大长度： 32
teamName	球队名称	是	string	最大长度： 64
logo	球队logo的URL地址	是	string	最大长度： 512
score	得分	否	long	/
prescore	大比分	否	long	/

1.5.9 Interaction

成员名称	描述	是否必选	类型	取值范围
webURL	点击整个卡片需要实际跳转的H5链接，要求为https地址。	否	string	最大长度： 512
deepLink	对原生App的跳转	否	NativeAppLinkInteraction	/
quickApp	对快应用的扩展	否	QuickAppLinkInteraction	/

1.5.10 NativeAppLinkInteraction

对原生App的跳转

成员名称	描述	是否必选	类型	取值范围
url	App的deeplink地址	是	string	最大长度： 512
appName	App名称	否	string	最大长度： 256
appPackage	App包名	是	string	最大长度： 256
minVersion	支持的APP的最小版本号VersionCode	是	long	/
minAndroidAPILevel	所需android最小API Level	否	long	/

1.5.11 QuickAppLinkInteraction

对快应用的扩展

成员名称	描述	是否必选	类型	取值范围
url	快应用的deeplink地址。	是	string	最大长度： 512
minPlatformVersion	所需快应用引擎最小版本号。	是	long	/
minVersion	支持的快应用的最小版本号VersionCode。	是	long	/

1.5.12 Image

单个图片信息

成员名称	描述	是否必选	类型	取值范围
url	图片URL，要求为https格式。	是	string	最大长度： 512
widthPixels	图片宽度（像素）	是	long	最小值： 1，最大值： 16384
heightPixels	图片高度（像素）	是	long	最小值： 1，最大值： 16384

1.5.13 ImageInfo

图片信息，至少提供一张图。

成员名称	描述	是否必选	类型	取值范围
small	小图	否	Image	/
medium	中图	否	Image	/
large	大图	否	Image	/