账户
浏览产品与网站导航

获取北单比赛开奖结果

GET https://api.superscore.cn/football/lottery/beiDanResultList

接口说明

建议每60秒更新

请求方式
GET
请求地址
https://api.superscore.cn/football/lottery/beiDanResultList
Content-Type
application/x-www-form-urlencoded;charset=UTF-8

请求头与鉴权

字段类型必填文档示例值说明
tokenstring是传商户KEYtoken(传商户KEY)仅供测试,正式站请设置IP

商户密钥仅保存在自己的服务端。测试 token 与正式 IP 授权的适用范围以本表及账户授权说明为准。

请求参数

Query 查询参数

字段类型必填文档示例值说明
issuestring否—期号（不传默认最新一期）
classifyint32否11足球

示例值用于说明字段；比赛、球队、联赛等 ID 应从实际接口取得，不能直接使用占位值。字段中的日期、枚举、分页范围与更新建议完整保留原始说明。

调用示例

替换 YOUR_MERCHANT_KEY、YOUR_MATCH_ID 等占位值后，在已授权的服务端调用。示例不会在本页面发起真实请求。

cURL

curl --get 'https://api.superscore.cn/football/lottery/beiDanResultList' \
  --header 'token: YOUR_MERCHANT_KEY' \
  --data-urlencode 'issue=YOUR_ISSUE' \
  --data-urlencode 'classify=1'

JavaScript / Node.js

// 仅在服务端保存商户密钥；替换示例占位值。
const url = new URL("https://api.superscore.cn/football/lottery/beiDanResultList");
url.search = new URLSearchParams({
  "issue": "YOUR_ISSUE",
  "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 = {
  "issue": "YOUR_ISSUE",
  "classify": "1"
}
headers = {
  "token": "YOUR_MERCHANT_KEY"
}
url = "https://api.superscore.cn/football/lottery/beiDanResultList"
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 均按接口定义列出。

字段路径类型说明与枚举
successboolean状态码
codestring状态编号
messagestring描述
dataobject数据
data.issuestring期号
data.countint32场次数量
data.matchesarray比赛列表
data.matches[].matchIdint32比赛ID
data.matches[].matchCodestring场次编号
data.matches[].timeint32比赛时间
data.matches[].homeIdint32主队ID
data.matches[].awayIdint32客队ID
data.matches[].homeTeamobject主队数据
data.matches[].homeTeam.teamIdint32球队ID
data.matches[].homeTeam.typeint32类型：0俱乐部,1国家队
data.matches[].homeTeam.nameEnstring球队名称（英文）
data.matches[].homeTeam.nameShortEnstring球队短名称（英文）
data.matches[].homeTeam.nameZhstring球队名称（中文）
data.matches[].homeTeam.nameShortZhstring球队短名称（中文）
data.matches[].homeTeam.nameZhtstring球队名称（繁体中文）
data.matches[].homeTeam.nameShortZhtstring球队短名称（繁体中文）
data.matches[].homeTeam.countryIdstring国家ID
data.matches[].homeTeam.foundedstring成立时间
data.matches[].homeTeam.venueIdint32球场ID
data.matches[].homeTeam.imagestring球队图片
data.matches[].homeTeam.coachIdint32教练ID
data.matches[].awayTeamobject客队数据
data.matches[].awayTeam.teamIdint32球队ID
data.matches[].awayTeam.typeint32类型：0俱乐部,1国家队
data.matches[].awayTeam.nameEnstring球队名称（英文）
data.matches[].awayTeam.nameShortEnstring球队短名称（英文）
data.matches[].awayTeam.nameZhstring球队名称（中文）
data.matches[].awayTeam.nameShortZhstring球队短名称（中文）
data.matches[].awayTeam.nameZhtstring球队名称（繁体中文）
data.matches[].awayTeam.nameShortZhtstring球队短名称（繁体中文）
data.matches[].awayTeam.countryIdstring国家ID
data.matches[].awayTeam.foundedstring成立时间
data.matches[].awayTeam.venueIdint32球场ID
data.matches[].awayTeam.imagestring球队图片
data.matches[].awayTeam.coachIdint32教练ID
data.matches[].leagueobject联赛数据
data.matches[].league.leagueIdint32联赛ID
data.matches[].league.nameEnstring联赛名称（英文）
data.matches[].league.nameShortEnstring联赛短名称（英文）
data.matches[].league.nameZhstring联赛名称（中文）
data.matches[].league.nameShortZhstring联赛短名称（中文）
data.matches[].league.nameZhtstring联赛名称（繁体中文）
data.matches[].league.nameShortZhtstring联赛短名称（繁体中文）
data.matches[].league.countryIdstring国家ID
data.matches[].league.seasonstring当前赛季
data.matches[].league.dateStartstring开始时间
data.matches[].league.dateEndstring结束时间
data.matches[].league.isCupint32赛事类型：联赛0,杯赛1
data.matches[].league.liveLineupsint32是否有阵容
data.matches[].league.liveStatsint32是否有球员统计
data.matches[].league.imagestring联赛图片
data.matches[].league.colorstring颜色
data.matches[].handicapstring让球数
data.matches[].spfOddsarray胜平负赔率（主胜/平/客胜）
data.matches[].statusint32比赛状态

响应结构示例

下面的值仅展示字段类型，不是实时数据或真实调用结果。动态 map 的键取决于实际返回，不编造固定字段。

展开完整 JSON 结构
{
  "success": false,
  "code": "示例字符串",
  "message": "示例字符串",
  "data": {
    "issue": "示例字符串",
    "count": 0,
    "matches": [
      {
        "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": "示例字符串"
        },
        "handicap": "示例字符串",
        "spfOdds": [],
        "status": 0
      }
    ]
  }
}

错误处理与使用说明

  1. 先检查 HTTP 状态，再解析 JSON；网络失败或非 JSON 响应不能当作成功。
  2. 业务响应 success 为 false 时，读取 code 和 message；不要把业务错误与 HTTP 状态混为一谈。
  3. 保存原始错误码、请求时间及接口路径用于排查，日志中移除商户密钥。
  4. 按该接口的数据更新建议、账户授权和调用频率请求；日期和时间戳单位以字段说明为准。
  5. 允许字段缺失或数据为空，按接口中的稳定 ID 关联资料，不依赖数组顺序。