文档中心 · JSON接口 · Webhook
API文档 — 极速11选5开奖数据接口
极速11选5提供权威实时的开奖查询与高频彩票数据API接口,稳定低延迟,面向中国大陆场景的合规数据服务。。本页提供高频场景下的接口规范、认证方式、示例与合规指引,帮助你快速完成集成。
HTTPS Only
低延迟推送
签名验真
快速开始
面向“开奖查询、历史数据、走势图计算、订阅推送”的集成场景,支持 REST JSON 与 Webhook。
- 申请并获取 API Key(主/备),配置回调地址(可选)。
- 在测试环境完成连通性校验与签名验证。
- 根据业务选择轮询(REST)或订阅(Webhook)模式。
- 上线前设置限流阈值、告警与重试策略。
示例:获取最新开奖(cURL)
# BaseURL 示例(仅示意)
curl -s -X GET "https://api.example.com/v1/draws/latest?game=js11x5" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Accept: application/json"
认证与安全
- Header 认证: 使用 X-API-Key: YOUR_API_KEY 或 Authorization: Bearer YOUR_API_KEY。
- IP 白名单: 建议在控制台配置来源 IP 段,阻断非授权请求。
- HTTPS 强制: 所有接口仅接受 TLS 1.2+,拒绝明文请求。
- Webhook 签名: 回调请求携带 X-Signature 与 X-Timestamp。X-Signature = HMAC-SHA256(body + timestamp, WEBHOOK_SECRET)。
校验示例(Node.js)
const crypto = require('crypto');
function verifySignature(body, ts, sig, secret) {
const payload = body + ts;
const digest = crypto.createHmac('sha256', secret).update(payload).digest('hex');
return crypto.timingSafeEqual(Buffer.from(digest), Buffer.from(sig));
}
数据接口(REST JSON)
覆盖“最新开奖、历史记录、单期查询、走势图数据”等高频使用场景。
GET /v1/draws/latest
查询指定游戏的最新一期开奖。
- Query: game=js11x5
- Headers: X-API-Key
{
"game": "js11x5",
"issue": "20260211-093",
"openTime": "2026-02-11T10:35:00+08:00",
"numbers": ["03","07","08","09","11"],
"status": "open",
"sync": "official"
}
GET /v1/draws/{date}
按日期拉取历史开奖(分页)。
- Path: {date}=YYYY-MM-DD
- Query: game=js11x5, page=1, pageSize=50
{
"date": "2026-02-10",
"page": 1,
"pageSize": 50,
"items": [
{ "issue": "20260210-120", "openTime": "2026-02-10T23:59:00+08:00", "numbers": ["01","02","04","06","10"] }
]
}
GET /v1/draws/issue/{issue}
按期号查询单期详情。
- Path: {issue}=YYYYMMDD-XXX
- Query: game=js11x5
{
"issue": "20260211-093",
"openTime": "2026-02-11T10:35:00+08:00",
"numbers": ["03","07","08","09","11"],
"meta": { "delayMs": 180, "source": "official-sync" }
}
GET /v1/trends
获取基础走势图所需的号码频次与遗漏值。
- Query: game=js11x5, limit=100
{
"game": "js11x5",
"limit": 100,
"freq": { "01": 9, "02": 7, "03": 11, "04": 8, "05": 10, "06": 6, "07": 12, "08": 9, "09": 15, "10": 7, "11": 6 },
"omit": { "01": 4, "02": 2, "03": 0, "04": 1, "05": 3, "06": 6, "07": 0, "08": 2, "09": 0, "10": 5, "11": 7 }
}
Webhook 回调
推荐使用订阅模式,降低轮询压力与延迟,事件到达后在本地持久化并二次校验。
- 事件类型:draw.published(开奖同步)、draw.corrected(异常修正,少见)。
- 重试策略:失败后 10s、30s、60s 阶梯重试,最多 5 次。
- 签名字段:X-Signature, X-Timestamp。
示例 Payload(draw.published)
{
"event": "draw.published",
"sentAt": "2026-02-11T10:35:02+08:00",
"data": {
"game": "js11x5",
"issue": "20260211-093",
"numbers": ["03","07","08","09","11"],
"openTime": "2026-02-11T10:35:00+08:00"
}
}
回调头示例:X-Signature: 9a3f...(hex),X-Timestamp: 1739241302
字段说明
- game · string · 游戏标识(例:js11x5)。
- issue · string · 期号(YYYYMMDD-XXX)。
- openTime · ISO8601 · 官方开奖时间(+08:00)。
- numbers · array[string] · 开奖号码(长度 5,范围 01–11)。
- status · enum · open|pending|corrected。
- sync · string · 数据同步策略标记(official / mirror)。
- meta.delayMs · number · 接入端观测延迟(毫秒)。
- traceId · string · 请求链路标识(用于故障排查)。
状态码与错误
- 200 成功。
- 400 参数错误(检查必填字段与格式)。
- 401 未认证(缺少或错误的 API Key)。
- 403 禁止访问(不在白名单/权限不足)。
- 404 资源不存在(期号或日期无数据)。
- 429 频率受限(触发限流)。
- 500 服务异常(可退避重试并上报 traceId)。
标准错误响应
{
"error": {
"code": "RATE_LIMITED",
"message": "Too many requests",
"traceId": "b6e1f2f0-1c9a-4a6f-9c3d-xxxx"
}
}
限流与稳定性
- 限流策略:Token Bucket + 平滑突发处理。
- 建议阈值:单 IP 每秒请求数遵循购买档位;超额返回 429。
- 重试建议:指数退避(如 0.5s、1s、2s),尊重 Retry-After。
- 高可用:请配置主备 Key 与多线路 DNS,启用失败切换。
连通性自检脚本(bash)
for i in {1..3}; do
curl -s -o /dev/null -w "%{http_code}\n" \
-H "X-API-Key: $API_KEY" \
"https://api.example.com/v1/health" || sleep $((2**i))
done
评估容量与并发建议
SDK 与示例
JavaScript fetch
const res = await fetch(
'https://api.example.com/v1/draws/latest?game=js11x5',
{ headers: { 'X-API-Key': process.env.API_KEY } }
);
const data = await res.json();
PHP(cURL)
$ch = curl_init('https://api.example.com/v1/draws/latest?game=js11x5');
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => ['X-API-Key: '.getenv('API_KEY')],
CURLOPT_RETURNTRANSFER => true
]);
$body = curl_exec($ch);
$data = json_decode($body, true);
Webhook(Express)
app.post('/webhook', express.text({ type: '*/*' }), (req, res) => {
const ts = req.header('X-Timestamp'); const sig = req.header('X-Signature');
if (!verifySignature(req.body, ts, sig, process.env.WEBHOOK_SECRET)) {
return res.status(400).send('invalid signature');
}
// handle event
res.sendStatus(200);
});
变更日志(节选)
- 2026-02-11:新增字段 traceId;完善 draw.corrected 事件描述。
- 2026-01-28:优化限流提示,返回 Retry-After 头。
- 2025-12-10:趋势接口 /v1/trends 上线。
常见问题
接口用途是什么?
面向合规的信息展示、历史统计与系统集成,不提供也不引导任何投注行为。
数据延迟与一致性如何保障?
采用官方同步与多源校验机制,结合签名链路与容灾策略,确保稳定可用。
是否提供沙箱?
支持测试密钥与沙箱回调方便联调,请在申请时备注。
合规与使用规范
- 遵循所在地法律法规,仅用于信息服务与技术开发。
- 不得将数据用于非法或诱导性活动;不得向未成年人展示相关内容。
- 展示数据时应标注来源与时间,不误导用户。