开发者文档
开放接口文档
PC28开放平台提供免费、只读的 PC28 开奖、Keno 源数据、统计、遗漏、长龙、四维人工智能和算法大厅接口。HTTPS only,支持 JSON / XML;只需 API Key。
- BASE URL
- 本站域名
- 鉴权
- X-Api-Key / Bearer
- 格式
- JSON / XML
- 时区
- 北京时间
- 费用
- 免费
- 限流
- 按密钥
接口一览
所有接口均为 GET;PC28 不包含 HX28。
开奖数据
最近 N 期开奖与下期倒计时
/api/kj · nbr=1–100需自带参数
按期号查开奖
按期号取一期开奖结果
/api/gq · nbr=期号(必填)Keno 开奖源数据
最近 N 期 Keno 二十码
/api/keno · nbr=1–100已开统计
当日各玩法已开次数
/api/yk遗漏
常规、球类与其他遗漏
/api/yl · window≤1000长龙
进行中的连开形态
/api/cl · filter / minLength / window人工智能·单双
单双预测与开奖对照
/api/ds · nbr=1–100人工智能·大小
大小预测与开奖对照
/api/dx · nbr=1–100人工智能·双组
双组预测与开奖对照
/api/sz · nbr=1–100人工智能·杀组
杀组预测与开奖对照
/api/sha · nbr=1–100算法大厅
公开算法与近窗胜率
/api/dt · sort / window / page需自带参数
算法详情
预测与逐期命中记录
/api/sf · id=展示序号(必填)接入约定
| nbr 两种含义 | /api/kj、/api/keno、预测接口表示条数 1–100;/api/gq 表示期号。 |
|---|---|
| 无效参数 | 未知参数或越界值返回 HTTP 400 VALIDATION,不静默修改。 |
| 开奖字段 | number 为三球表达式,num 为和值;所有时间为北京时间。 |
| 期号类型 | 开奖与预测期号均为数字;算法 id 为展示序号。 |
| XML | 加 ?format=xml 或 Accept: application/xml;字段语义与 JSON 相同。 |
AI 读版
AI 对接请直接读取本页语义和接口示例,不要抓取页面 HTML。公开接口不返回算法公式。
请阅读本站 /docs 的开放接口约定。
找出 PC28 开奖、Keno、遗漏、长龙和四维预测接口。
统一使用 X-Api-Key,请解释 nbr 在列表与按期号查询中的不同含义。快速开始
- 在用户中心生成 API Key,明文只显示一次。
- 请求头携带 X-Api-Key。
- 调用 /api/kj?format=json&nbr=1 验证连通。
curl -sS -H 'X-Api-Key: YOUR_API_KEY' \
'https://你的域名/api/kj?format=json&nbr=1'const response = await fetch('/api/kj?nbr=1', {
headers: { 'X-Api-Key': process.env.PC28_API_KEY },
});
const body = await response.json();鉴权与 Key
优先使用请求头 X-Api-Key,也兼容 Authorization: Bearer <API Key>。密钥不要放进 URL、前端源码或公开仓库;不用的密钥请在用户中心停用。
响应格式
成功返回 HTTP 200。默认 JSON;使用 ?format=xml 获得等价 XML。列表按最新期号倒序。
{
"items": [{ "drawNbr": 3472610, "number": "1+6+2", "sum": 9 }],
"total": 1
}错误处理
| HTTP | code | 含义 |
|---|---|---|
| 400 | VALIDATION | 参数无效 |
| 401 | UNAUTHORIZED | 缺少或无效 API Key |
| 404 | NOT_FOUND | 资源不存在 |
| 429 | RATE_LIMITED | 请求过于频繁 |
| 503 | UNAVAILABLE | 数据暂不可用 |
开奖数据 /api/kj
最近 N 期开奖与下期倒计时。nbr=1–100。
GET /api/kj?format=json&nbr=10
X-Api-Key: YOUR_API_KEY按期号查开奖 /api/gq
按期号取一期开奖结果。nbr=期号(必填)。
GET /api/gq?format=json&nbr=<期号>
X-Api-Key: YOUR_API_KEYKeno 开奖源数据 /api/keno
最近 N 期 Keno 二十码。nbr=1–100。
GET /api/keno?format=json&nbr=10
X-Api-Key: YOUR_API_KEY已开统计 /api/yk
当日各玩法已开次数。无需参数。
GET /api/yk?format=json
X-Api-Key: YOUR_API_KEY遗漏 /api/yl
常规、球类与其他遗漏。window≤1000。
GET /api/yl?format=json
X-Api-Key: YOUR_API_KEY长龙 /api/cl
进行中的连开形态。filter / minLength / window。
GET /api/cl?format=json
X-Api-Key: YOUR_API_KEY人工智能·单双 /api/ds
单双预测与开奖对照。nbr=1–100。
GET /api/ds?format=json&nbr=10
X-Api-Key: YOUR_API_KEY人工智能·大小 /api/dx
大小预测与开奖对照。nbr=1–100。
GET /api/dx?format=json&nbr=10
X-Api-Key: YOUR_API_KEY人工智能·双组 /api/sz
双组预测与开奖对照。nbr=1–100。
GET /api/sz?format=json&nbr=10
X-Api-Key: YOUR_API_KEY人工智能·杀组 /api/sha
杀组预测与开奖对照。nbr=1–100。
GET /api/sha?format=json&nbr=10
X-Api-Key: YOUR_API_KEY算法大厅 /api/dt
公开算法与近窗胜率。sort / window / page。
GET /api/dt?format=json
X-Api-Key: YOUR_API_KEY算法详情 /api/sf
预测与逐期命中记录。id=展示序号(必填)。
GET /api/sf?format=json&id=<算法编号>
X-Api-Key: YOUR_API_KEY