接口说明
建议每60秒更新
- 请求方式
GET- 请求地址
https://api.superscore.cn/football/lottery/lotteryResultList- Content-Type
application/x-www-form-urlencoded;charset=UTF-8
请求头与鉴权
| 字段 | 类型 | 必填 | 文档示例值 | 说明 |
|---|---|---|---|---|
token | string | 是 | 传商户KEY | token(传商户KEY)仅供测试,正式站请设置IP |
商户密钥仅保存在自己的服务端。测试 token 与正式 IP 授权的适用范围以本表及账户授权说明为准。
请求参数
Query 查询参数
| 字段 | 类型 | 必填 | 文档示例值 | 说明 |
|---|---|---|---|---|
date | string | 否 | 2023-08-01 | 日期 |
classify | int32 | 否 | 1 | 1足球 2篮球 |
示例值用于说明字段；比赛、球队、联赛等 ID 应从实际接口取得，不能直接使用占位值。字段中的日期、枚举、分页范围与更新建议完整保留原始说明。
调用示例
替换 YOUR_MERCHANT_KEY、YOUR_MATCH_ID 等占位值后，在已授权的服务端调用。示例不会在本页面发起真实请求。
cURL
curl --get 'https://api.superscore.cn/football/lottery/lotteryResultList' \
--header 'token: YOUR_MERCHANT_KEY' \
--data-urlencode 'date=YYYY-MM-DD' \
--data-urlencode 'classify=1'JavaScript / Node.js
// 仅在服务端保存商户密钥；替换示例占位值。
const url = new URL("https://api.superscore.cn/football/lottery/lotteryResultList");
url.search = new URLSearchParams({
"date": "YYYY-MM-DD",
"classify": "1"
});
const response = await fetch(url, {
method: "GET",
headers: {
"token": "YOUR_MERCHANT_KEY"
}
});
if (!response.ok) throw new Error('HTTP ' + response.status);
const result = await response.json();
if (result.success !== true) throw new Error(String(result.message || result.code));
console.log(result.data);Python 标准库示例
# 标准库示例；商户密钥仅保存在服务端。
import json
from urllib.parse import urlencode
from urllib.request import Request, urlopen
parameters = {
"date": "YYYY-MM-DD",
"classify": "1"
}
headers = {
"token": "YOUR_MERCHANT_KEY"
}
url = "https://api.superscore.cn/football/lottery/lotteryResultList"
if parameters:
url += '?' + urlencode(parameters)
with urlopen(Request(url, headers=headers, method="GET"), timeout=15) as response:
result = json.load(response)
if not result.get('success'):
raise RuntimeError(result.get('message') or result.get('code'))
print(result.get('data'))返回参数
字段路径保留完整层级；[] 表示数组元素，<key> 表示按数据内容变化的映射键。success、code、message 与 data 均按接口定义列出。
| 字段路径 | 类型 | 说明与枚举 |
|---|---|---|
success | boolean | 状态码 |
code | string | 状态编号 |
message | string | 描述 |
data | array | 数据 |
data[].matchId | int32 | 比赛ID |
data[].matchCode | string | 场次编号 |
data[].time | int32 | 比赛时间 |
data[].homeId | int32 | 主队ID |
data[].awayId | int32 | 客队ID |
data[].homeTeam | object | 主队数据 |
data[].homeTeam.teamId | int32 | 球队ID |
data[].homeTeam.type | int32 | 类型：0俱乐部,1国家队 |
data[].homeTeam.nameEn | string | 球队名称（英文） |
data[].homeTeam.nameShortEn | string | 球队短名称（英文） |
data[].homeTeam.nameZh | string | 球队名称（中文） |
data[].homeTeam.nameShortZh | string | 球队短名称（中文） |
data[].homeTeam.nameZht | string | 球队名称（繁体中文） |
data[].homeTeam.nameShortZht | string | 球队短名称（繁体中文） |
data[].homeTeam.countryId | string | 国家ID |
data[].homeTeam.founded | string | 成立时间 |
data[].homeTeam.venueId | int32 | 球场ID |
data[].homeTeam.image | string | 球队图片 |
data[].homeTeam.coachId | int32 | 教练ID |
data[].awayTeam | object | 客队数据 |
data[].awayTeam.teamId | int32 | 球队ID |
data[].awayTeam.type | int32 | 类型：0俱乐部,1国家队 |
data[].awayTeam.nameEn | string | 球队名称（英文） |
data[].awayTeam.nameShortEn | string | 球队短名称（英文） |
data[].awayTeam.nameZh | string | 球队名称（中文） |
data[].awayTeam.nameShortZh | string | 球队短名称（中文） |
data[].awayTeam.nameZht | string | 球队名称（繁体中文） |
data[].awayTeam.nameShortZht | string | 球队短名称（繁体中文） |
data[].awayTeam.countryId | string | 国家ID |
data[].awayTeam.founded | string | 成立时间 |
data[].awayTeam.venueId | int32 | 球场ID |
data[].awayTeam.image | string | 球队图片 |
data[].awayTeam.coachId | int32 | 教练ID |
data[].league | object | 联赛数据 |
data[].league.leagueId | int32 | 联赛ID |
data[].league.nameEn | string | 联赛名称（英文） |
data[].league.nameShortEn | string | 联赛短名称（英文） |
data[].league.nameZh | string | 联赛名称（中文） |
data[].league.nameShortZh | string | 联赛短名称（中文） |
data[].league.nameZht | string | 联赛名称（繁体中文） |
data[].league.nameShortZht | string | 联赛短名称（繁体中文） |
data[].league.countryId | string | 国家ID |
data[].league.season | string | 当前赛季 |
data[].league.dateStart | string | 开始时间 |
data[].league.dateEnd | string | 结束时间 |
data[].league.isCup | int32 | 赛事类型：联赛0,杯赛1 |
data[].league.liveLineups | int32 | 是否有阵容 |
data[].league.liveStats | int32 | 是否有球员统计 |
data[].league.image | string | 联赛图片 |
data[].league.color | string | 颜色 |
data[].homeScore | string | 主队比分 |
data[].awayScore | string | 客队比分 |
data[].status | int32 | 比赛状态 |
data[].spfOdds | array | 胜平负赔率（主胜/平/客胜） |
data[].rqspfOdds | array | 让球胜平负赔率 |
data[].handicap | string | 让球数 |
data[].bfOdds | map | 比分赔率 |
data[].zjqOdds | map | 总进球赔率 |
data[].bqcOdds | map | 半全场赔率 |
响应结构示例
下面的值仅展示字段类型，不是实时数据或真实调用结果。动态 map 的键取决于实际返回，不编造固定字段。
展开完整 JSON 结构
{
"success": false,
"code": "示例字符串",
"message": "示例字符串",
"data": [
{
"matchId": 0,
"matchCode": "示例字符串",
"time": 0,
"homeId": 0,
"awayId": 0,
"homeTeam": {
"teamId": 0,
"type": 0,
"nameEn": "示例字符串",
"nameShortEn": "示例字符串",
"nameZh": "示例字符串",
"nameShortZh": "示例字符串",
"nameZht": "示例字符串",
"nameShortZht": "示例字符串",
"countryId": "示例字符串",
"founded": "示例字符串",
"venueId": 0,
"image": "示例字符串",
"coachId": 0
},
"awayTeam": {
"teamId": 0,
"type": 0,
"nameEn": "示例字符串",
"nameShortEn": "示例字符串",
"nameZh": "示例字符串",
"nameShortZh": "示例字符串",
"nameZht": "示例字符串",
"nameShortZht": "示例字符串",
"countryId": "示例字符串",
"founded": "示例字符串",
"venueId": 0,
"image": "示例字符串",
"coachId": 0
},
"league": {
"leagueId": 0,
"nameEn": "示例字符串",
"nameShortEn": "示例字符串",
"nameZh": "示例字符串",
"nameShortZh": "示例字符串",
"nameZht": "示例字符串",
"nameShortZht": "示例字符串",
"countryId": "示例字符串",
"season": "示例字符串",
"dateStart": "示例字符串",
"dateEnd": "示例字符串",
"isCup": 0,
"liveLineups": 0,
"liveStats": 0,
"image": "示例字符串",
"color": "示例字符串"
},
"homeScore": "示例字符串",
"awayScore": "示例字符串",
"status": 0,
"spfOdds": [],
"rqspfOdds": [],
"handicap": "示例字符串",
"bfOdds": {},
"zjqOdds": {},
"bqcOdds": {}
}
]
}错误处理与使用说明
- 先检查 HTTP 状态，再解析 JSON；网络失败或非 JSON 响应不能当作成功。
- 业务响应 success 为 false 时，读取 code 和 message；不要把业务错误与 HTTP 状态混为一谈。
- 保存原始错误码、请求时间及接口路径用于排查，日志中移除商户密钥。
- 按该接口的数据更新建议、账户授权和调用频率请求；日期和时间戳单位以字段说明为准。
- 允许字段缺失或数据为空，按接口中的稳定 ID 关联资料，不依赖数组顺序。