数据接口
数据接口 + 开奖动画嵌入 · 30 秒接入
① 一行拿到最新开奖
# 最新一期号码、特别号、承诺哈希
curl -s https://kinmen6.com/public/latest.json \
| jq '.issues[0] | {期号:.id, 日期:.drawDate, 号码:.numbers, 特别号:.special, 承诺哈希:.commitment}'
② 复制即用
JavaScript
const r = await fetch('https://kinmen6.com/public/latest.json').then(r => r.json());
const it = r.issues[0];
console.log(it.id, it.numbers.join(' '), '+', it.special);
Python
import json, urllib.request
d = json.load(urllib.request.urlopen('https://kinmen6.com/public/latest.json'))
it = d['issues'][0]
print(it['id'], it['numbers'], it['special'], it['commitment'][:16])
浏览器跨域注意：官网当前未开放 CORS，纯前端页面请由服务端代取（或用 /public/feeds/ 做服务端定时拉取）。本页部署在官网域名下为同源，可直连；也可以直接嵌入官网的开奖动画组件（见 ⑤），连跨域都不需要处理。
③ 端点一览
| 端点 | 说明 |
|---|
| /public/latest.json | 最新一期 + 最近 6 期（约 10 KB，推荐） |
| /api/state | 同上，简写别名 |
| /public/feeds/results.json | 结果 feed（JSON） |
| /public/feeds/results.xml | 结果 feed（XML） |
| /public/collector/recorded-history.json | 推荐：预承诺完整运行历史，排除演示及补生成 |
| /public/history.json | 兼容原始全量归档，包含明确标记的演示数据，不能全当真实开奖 |
| /public/receipts/{期号}/precommit.json | 单期承诺存证回执 |
| /public/openapi.json | 完整 OpenAPI 文档 |
历史数据口径：正式采集优先使用 /public/collector/recorded-history.json。以它的 sourceArchiveVersion 对照实时数据的 historyVersion，变化后刷新；archiveVersion标识筛选后的内容。原始归档中的 isHistoricalDemo=true、evidenceStatus=historical-demo 是演示材料；存在 GitHub 或时间戳记录不代表当年已预先存证。precommitted=true也不等于 OTS 已独立确认。
请求频率：实时数据及其别名共用每 IP 平均 2 次/秒预算；历史归档及别名共用每 IP 平均 6 次/分钟预算，允许短时突发。超限返回429及Retry-After，请缓存历史并退避重试。仍为免费公开，不要求API Key。
④ 关键字段
| 字段 | 类型 | 说明 |
|---|
| issues[0].id | string | 期号，如 2026-297 |
| .numbers | int[6] | 六个开奖号码 |
| .special | int | 特别号 |
| .commitment | hex | 开奖前公布的承诺哈希（SEED-COMMIT-3.0） |
| .seed / .salt | hex | 开奖后公开的原始值，可自行复算校验 |
| .revealedAt | ISO | 公开时刻 |
| .evidence.receipt | path | 存证回执路径 |
| .evidence.external.* | object | GitHub 提交 + OTS 区块链时间戳 |
| currentDay.closeAt | ms | 封盘时刻（毫秒时间戳） |
| currentDay.revealAt | ms | 开奖时刻（每天 20:30 北京） |
⑤ 开奖动画：一行 iframe 嵌入你的网站
想让你的网站也有一个开奖动画？不用自己画球、不用处理跨域——把官网的动画组件嵌进来即可，节奏与官网开奖大厅实时同步：
<iframe src="https://kinmen6.com/draw.html"
width="100%" height="560" frameborder="0"
style="border:0;border-radius:14px;max-width:460px"></iframe>
| 参数 | 说明 |
|---|
| ?issue=2026-297 | 指定历史期次（默认今天 / 最新一期） |
| ?speed=fast | 已开完的期次自动快速回放（约 0.9 秒/球，适合做固定展示） |
同步规则
| 阶段 | 表现 |
|---|
| 未开奖 | 倒计时（北京时间每天 20:30 开奖），到点自动进入直播同步 |
| 正在开奖 | 约 20 秒揭晓一球，未揭晓的球持续滚动；中途嵌入也从当前真实进度接着走 |
| 特别号 | 压轴揭晓（约 45 秒），带聚光灯与金色光环 |
| 已开完 | 直接展示结果、承诺哈希与「官网核验存证」入口；「再看一次」可快速回放 |
为什么推荐 iframe 而不是直接 fetch：官网未开放 CORS，浏览器前端直连取数会被拦截；iframe 内的页面由官网域名自行取数（同源），你的页面只是一个容器，天然不受跨域限制，也不必担心接口变动。
接收开奖结果（postMessage）
window.addEventListener('message', e => {
const d = e.data;
if (d && d.source === 'kinmen-draw' && d.type === 'result') {
console.log(d.issue, d.numbers.join(' '), '+', d.special);
// 在这里把你的网站状态置为「已开奖」
}
});
现场预览
⑥ 现场试一下
点击上方按钮，从官网公开接口实时取数
数据可信在哪：每期开奖前先公布承诺哈希（commitment），开奖后再公开 seed 与 salt——任何人都能复算验证「结果在开奖前就已确定、事后不可篡改」。存证同步落到 GitHub 公开仓库与 OpenTimestamps 区块链时间戳。