开放接口文档

12 个端点与 开放接口门户 一一对应。路径为短码（兼容旧开放面），不是 REST 资源名。所有数据接口均为 GET。

开奖数据最近 N 期开奖与下期倒计时；不传 game 为加拿大28/api/kj · nbr = 条数 1–100按期号查开奖按期号取单期；倒计时仍相对最新期/api/qh · nbr = 期号（必填）Keno 开奖源数据最近 N 期 Keno 二十码（仅加拿大28）/api/keno · nbr = 条数 1–100已开统计当日各玩法已开次数；响应带北京日历日 date/api/yk遗漏各玩法未开期数，含常规与球类/api/yl长龙连开形态（进行中 / 已断开），含起止期号/api/cl人工智能·单双单双预测与开奖对照/api/ds · nbr = 条数 1–100人工智能·大小大小预测与开奖对照/api/dx · nbr = 条数 1–100人工智能·双组双组预测与开奖对照/api/sz · nbr = 条数 1–100人工智能·杀组杀组预测与开奖对照/api/sha · nbr = 条数 1–100算法大厅公开算法列表；近 20/100 期胜率，id 为展示序号/api/dt · sort / window / page算法详情下期预测与近窗记录（不含公式）/api/sf · id = 展示序号（必填）

下列语义已与现网对齐。对接时按此实现，不要按字段名猜测。

• AI 读版：/developers/open-api.llms.md
• 可对助手说：「按 https://yu28.top/developers/open-api.llms.md 接入开放接口」

一键提示词

请阅读 https://yu28.top/developers/open-api.llms.md
按其中的白名单路径与鉴权规则，用我的 YU28_API_KEY 写对接代码。
不要依赖 /bff/*；算法 id 用展示序号而非 UUID。
nbr 在 kj/keno/预测是条数，在 qh 是期号。

1. 1在 /app?tab=api 生成 Key（明文只显示一次，请立刻保存）
2. 2请求头携带 X-Api-Key: yu28_…，不要把个人 Key 放进 URL
3. 3拉取 /api/kj.json?nbr=1 验证连通

cURL

curl -sS -H "X-Api-Key: $YU28_API_KEY" \
  "https://yu28.top/api/kj.json?nbr=1"

JavaScript

const res = await fetch("https://yu28.top/api/kj.json?nbr=1", {
  headers: { "X-Api-Key": process.env.YU28_API_KEY },
});
const body = await res.json();
if (!res.ok) throw new Error(body?.error?.message ?? res.statusText);

Python

import os, requests

r = requests.get(
    "https://yu28.top/api/kj.json",
    params={"nbr": 1},
    headers={"X-Api-Key": os.environ["YU28_API_KEY"]},
    timeout=15,
)
r.raise_for_status()
print(r.json())

GET /api/kj.json?nbr=1 HTTP/1.1
Host: yu28.top
X-Api-Key: yu28_你的密钥

# 等价
Authorization: Bearer yu28_你的密钥

• 个人 Key 禁止放在 URL ?key= 或 ?api_key=（二者同等；仅门户 Demo Key 可用 query）。误传个人 Key 会 401
• 个人 Key 数据面不限流、不配额计费。Demo Key 按 IP 每分钟最多 60 次，超出 429 RATE_LIMIT
• 管理入口：用户中心 / 接口管理

本文示例一律 JSON。成功 HTTP 200；路径加 .json 或省略后缀（默认 JSON）。字段为驼峰 / 短英文键。

失败时 HTTP 为 4xx / 5xx，body 始终为 JSON（含请求 .xml 时）：

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "无效的 API Key"
  }
}

最近 N 期开奖（最新在前）。此处 nbr 是条数，不是期号。省略为 1；写出则须为 1–100 的正整数，否则 400。只有 game=hx28 切哈希28；其它值按加拿大28。哈希28 行在有值时另带高度 / 哈希 / md5。

GET /api/kj.json?nbr=3

{
  "countdown": "02:40",
  "data": [
    {
      "nbr": "3463701",
      "time": "2026-07-31 11:25:00",
      "number": "4+8+2=14",
      "combination": "小双"
    }
  ]
}

按期号取单期（须与 game 同一彩种）；字段与 /api/kj 单条一致。此处 nbr 是期号，必填正整数；缺参 400，查无 404。countdown 始终相对当前最新一期，不是所查那一期。

GET /api/qh.json?nbr=3463701

{
  "countdown": "02:40",
  "data": [
    {
      "nbr": "3463701",
      "time": "2026-07-31 11:25:00",
      "number": "4+8+2=14",
      "combination": "小双"
    }
  ]
}

最近 N 期 Keno 二十码（仅加拿大28）。nbr 与 /api/kj 相同，表示条数。 哈希28没有 Keno：game=hx28 → 400 VALIDATION。

GET /api/keno.json?nbr=1

{
  "data": [
    {
      "nbr": "3463701",
      "time": "2026-07-31 11:25:00",
      "nbrs": "1,4,7,9,20,23,25,26,27,31,38,39,49,52,54,56,58,62,72,74"
    }
  ]
}

nbrs：20 个号码，逗号分隔、无空格。time 为源日期与时刻拼接（如 2026-07-31 11:25:00），不是 ISO。

当日已开次数（北京日历日）。date 为该份次数所属日；data 为扁平 map（数字键 / 玩法文案键）。大+小约等于该日已开期数。客户端须核 date，隔日包勿当今日。

GET /api/yk.json

{ "date": "2026-08-30", "data": { "10": 8, "大": 102, "小单": 48 } }

data 扁平 map，值为遗漏期数；没有 date（以期号为版本）。

GET /api/yl.json

当前长龙列表。现网含进行中与已断开；status 为中文文案（「进行中」「已断开」），不要当机器枚举码。

GET /api/cl.json

{
  "data": [
    {
      "type": "周期",
      "content": "单双",
      "status": "进行中",
      "count": 8,
      "start": "3463693",
      "current": "3463700"
    }
  ]
}

四维路径：/api/ds（单双）· /api/dx（大小）· /api/sz（双组）· /api/sha（杀组）。nbr 为条数（最近 N 条，含待开期），规则同 /api/kj。

GET /api/ds.json?nbr=10

{
  "data": [
    {
      "nbr": "3466878",
      "predict": "双",
      "number": null,
      "num": null,
      "result": null,
      "hit": null
    },
    {
      "nbr": "3466877",
      "predict": "单",
      "number": "1+2+3",
      "num": "6",
      "result": "单",
      "hit": true
    }
  ]
}

字段与 /api/ds 相同；predict / result 为大小维度。

GET /api/dx.json?nbr=10

字段与 /api/ds 相同；predict / result 为双组组合文案。

GET /api/sz.json?nbr=10

字段与 /api/ds 相同；predict 为组合名（不含「杀」前缀）。

GET /api/sha.json?nbr=10

公开算法排序列表。返回的 id 是主站展示序号（如 #909），不是 UUID。未知 category 返回 400；未知 sort 回落到近 20 期胜率降序，响应里的 sort 是服务端实际键。

GET /api/dt.json?sort=rate_desc&window=20&pageSize=5

{
  "items": [
    {
      "id": 909,
      "name": "组合440",
      "category": "combo_predict",
      "author": "昵称",
      "hit20": "20/20",
      "hit100": "86/100",
      "streak": 24,
      "miss": 0,
      "maxStreak": 24,
      "maxMiss": 2
    }
  ],
  "page": 1,
  "pageSize": 5,
  "total": 8222,
  "category": null,
  "sort": "rate20_desc"
}

hit20 / hit100 为命中比（命中率 = 分子÷分母）；author 为昵称，可能为 null。响应 sort 是服务端实际键。

id 必填（该彩展示序号，可带 #）。不存在或未公开 → 404。在大厅字段上增加预测与近窗记录，不含公式。predict / predictNbr 在尚无下期预测时为 null。

• records：最多 100 条已开 + 可选待开一行（插在最前）
• 已开 number 为三位和式（与 /api/kj 相同，如 1+8+3=12）；待开行 time / number 为空串，hit 为 null

GET /api/sf.json?id=909