DEVELOPER DOCUMENTATION

开放接口文档

面向数据看板、机器人和分析工具的加拿大28只读数据接口。所有示例均对应本站当前真实返回结构。

Base URL: https://你的域名
鉴权: 当前公开只读
格式: JSON / XML
请求方式: GET
费用: 免费使用
时区: 北京时间

接口一览

点击卡片直接跳到参数和响应说明。

/api/kj开奖数据读取最近 N 期 PC28 开奖数据，并返回相对最新一期计算的倒计时。/api/qh按期号查开奖按完整期号读取单期开奖；倒计时仍以数据库最新一期为基准。/api/kenoKeno 开奖源数据读取最近 N 期已入库的 Keno 原始 20 球，仅支持加拿大28。/api/yk已开统计返回北京当日和值、组合、形态、余数及尾数的已开次数。/api/yl遗漏数据返回和值、常规玩法、形态、余数和尾数距最近一次开出的期数。/api/cl长龙返回当前或历史上满足条件的连续、跳开形态及起止期号。/api/ds人工智能·单双输出单双统计模型的下期预测及历史开奖对照。/api/dx人工智能·大小输出大小统计模型的下期预测及历史开奖对照。/api/sz人工智能·双组每期给出两组大小单双组合，并与真实组合回测。/api/sha人工智能·杀组返回低频排除组合；hit 表示真实组合未落入被排除项。/api/dt算法大厅分页读取公开算法、20/100期命中摘要与连中连挂数据。/api/sf算法详情用算法大厅返回的展示 ID 获取下期预测、摘要与最近 100 期记录。

接入约定

先统一期号、时间、空值和路径规则。

数据来自数据库，不在访问页面时重复抓取上游。

最近一期和历史分页均由本地数据中心输出；PC28 三个数字由已入库的 Keno 原始 20 球独立计算。

所有公开兼容接口均使用 GET。
nbr 在开奖、Keno 和四维模型中表示条数，范围为 1—100；在 /api/qh 中表示完整期号。
期号始终为字符串；时间为 YYYY-MM-DD HH:mm:ss 北京时间。
预测中的下一期待开奖字段为 null；算法详情待开奖记录的时间和号码为空字符串。
当前只接入加拿大28真实数据源。哈希28未接入，不会用加拿大28数据冒充。

快速开始

无需登录即可读取当前公开数据。

cURL

curl 'https://你的域名/api/kj.json?nbr=1'

JavaScript

const response = await fetch('https://你的域名/api/kj.json?nbr=1', {
  headers: { Accept: 'application/json' },
  cache: 'no-store'
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const payload = await response.json();
console.log(payload.data[0]);

Python

import requests

response = requests.get(
    'https://你的域名/api/kj.json',
    params={'nbr': 1},
    timeout=10,
)
response.raise_for_status()
print(response.json()['data'][0])

先调用 /api/dt 获取公开算法 ID，再把 ID 传给 /api/sf；查询已知期号请使用 /api/qh，不要用历史条数接口代替。

鉴权说明

当前部署与参考站的账户体系不同。

现阶段公开只读，无需 API Key

不要传入虚构的 Key。需要限制外部调用时，可在宝塔 Nginx 或数据中心前置网关增加来源、频率和令牌校验；启用前不会在文档中冒充已支持。

响应格式

通过路径后缀选择 JSON 或 XML。

JSON/api/kj/api/kj.json

无后缀和 .json 返回同一 JSON 结构。

XML/api/kj.xml

根节点为 <response>，数组项使用 <item>；纯数字键会加 k_ 前缀。

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <countdown>03:25</countdown>
  <data>
    <item>
      <nbr>3474282</nbr>
      <time>2026-08-26 18:56:30</time>
      <number>0+3+9=12</number>
      <combination>小双</combination>
    </item>
  </data>
</response>

错误处理

错误响应始终为 JSON，包含稳定的 code 和 message。

400VALIDATION参数格式或取值错误

404NOT_FOUND期号、算法或接口不存在

{
  "error": {
    "code": "VALIDATION",
    "message": "条数 nbr 须为 1–100 的正整数"
  }
}

12 个接口

GET

开奖数据

读取最近 N 期 PC28 开奖数据，并返回相对最新一期计算的倒计时。

/api/kj

JSON XML

查询参数

参数	必填	说明
`nbr`	否	返回条数，1—100，默认 1。

JSON 响应示例

{
  "countdown": "03:25",
  "data": [{
    "nbr": "3474282",
    "time": "2026-08-26 18:56:30",
    "number": "0+3+9=12",
    "combination": "小双"
  }]
}

GET

按期号查开奖

按完整期号读取单期开奖；倒计时仍以数据库最新一期为基准。

/api/qh

JSON XML

查询参数

参数	必填	说明
`nbr`	是	要查询的完整正整数期号。

JSON 响应示例

{
  "countdown": "03:25",
  "data": [{
    "nbr": "3474282",
    "time": "2026-08-26 18:56:30",
    "number": "0+3+9=12",
    "combination": "小双"
  }]
}

GET

Keno 开奖源数据

读取最近 N 期已入库的 Keno 原始 20 球，仅支持加拿大28。

/api/keno

JSON XML

查询参数

参数	必填	说明
`nbr`	否	返回条数，1—100，默认 1。

JSON 响应示例

{
  "data": [{
    "nbr": "3474282",
    "time": "2026-08-26 18:56:30",
    "nbrs": "2,5,8,12,16,19,23,27,31,34,38,42,45,49,53,58,62,67,71,79"
  }]
}

GET

已开统计

返回北京当日和值、组合、形态、余数及尾数的已开次数。

/api/yk

JSON XML

查询参数

参数	必填	说明
无需查询参数

JSON 响应示例

{
  "data": {
    "00": 0,
    "12": 14,
    "27": 0,
    "大": 188,
    "小单": 96,
    "3N余0": 131,
    "0尾": 38
  }
}

GET

遗漏数据

返回和值、常规玩法、形态、余数和尾数距最近一次开出的期数。

/api/yl

JSON XML

查询参数

参数	必填	说明
无需查询参数

JSON 响应示例

{
  "data": {
    "00": 48,
    "12": 0,
    "27": 71,
    "小双": 0,
    "对子": 6,
    "2尾": 0
  }
}

GET

长龙

返回当前或历史上满足条件的连续、跳开形态及起止期号。

/api/cl

JSON XML

查询参数

参数	必填	说明
无需查询参数

JSON 响应示例

{
  "data": [{
    "type": "单挑",
    "content": "大小",
    "status": "进行中",
    "count": 6,
    "start": "3474277",
    "current": "3474282"
  }]
}

GET

人工智能·单双

输出单双统计模型的下期预测及历史开奖对照。

/api/ds

JSON XML

查询参数

参数	必填	说明
`nbr`	否	预测与回测记录总条数，1—100，默认 1。

JSON 响应示例

{
  "data": [{
    "nbr": "3474283",
    "predict": "单",
    "number": null,
    "num": null,
    "result": null,
    "hit": null
  }]
}

GET

人工智能·大小

输出大小统计模型的下期预测及历史开奖对照。

/api/dx

JSON XML

查询参数

参数	必填	说明
`nbr`	否	预测与回测记录总条数，1—100，默认 1。

JSON 响应示例

{
  "data": [{
    "nbr": "3474282",
    "predict": "小",
    "number": "0+3+9",
    "num": "12",
    "result": "小",
    "hit": true
  }]
}

GET

人工智能·双组

每期给出两组大小单双组合，并与真实组合回测。

/api/sz

JSON XML

查询参数

参数	必填	说明
`nbr`	否	预测与回测记录总条数，1—100，默认 1。

JSON 响应示例

{
  "data": [{
    "nbr": "3474282",
    "predict": "小双,大双",
    "number": "0+3+9",
    "num": "12",
    "result": "小双",
    "hit": true
  }]
}

GET

人工智能·杀组

返回低频排除组合；hit 表示真实组合未落入被排除项。

/api/sha

JSON XML

查询参数

参数	必填	说明
`nbr`	否	预测与回测记录总条数，1—100，默认 1。

JSON 响应示例

{
  "data": [{
    "nbr": "3474282",
    "predict": "大单",
    "number": "0+3+9",
    "num": "12",
    "result": "小双",
    "hit": true
  }]
}

GET

算法大厅

分页读取公开算法、20/100期命中摘要与连中连挂数据。

/api/dt

JSON XML

查询参数

参数	必填	说明
`sort`	否	rate_desc、rate_asc、streak_desc、miss_desc 等排序。
`window`	否	命中率窗口，只接受 20 或 100，默认 20。
`page`	否	页码，默认 1。
`pageSize`	否	每页数量，最大 50，默认 20。
`category / q`	否	按算法分类或名称、作者关键字筛选。

JSON 响应示例

{
  "items": [{
    "id": 501,
    "name": "杀组低频",
    "category": "kill_group",
    "author": "北辰数据",
    "hit20": "16/20",
    "hit100": "79/100",
    "streak": 2,
    "miss": 0,
    "maxStreak": 14,
    "maxMiss": 3
  }],
  "page": 1,
  "pageSize": 5,
  "total": 10,
  "category": null,
  "sort": "rate20_desc"
}

GET

算法详情

用算法大厅返回的展示 ID 获取下期预测、摘要与最近 100 期记录。

/api/sf

JSON XML

查询参数

参数	必填	说明
`id`	是	算法大厅返回的正整数展示 ID，也支持去掉 # 后传入。

JSON 响应示例

{
  "id": 501,
  "name": "杀组低频",
  "category": "kill_group",
  "hit20": "16/20",
  "hit100": "79/100",
  "predict": "杀大单",
  "predictNbr": "3474283",
  "records": [{
    "time": "",
    "nbr": "3474283",
    "predict": "杀大单",
    "number": "",
    "hit": null
  }]
}