跳到主要内容
API abstract background

文档中心 · JSON接口 · Webhook

API文档 — 极速11选5开奖数据接口

极速11选5提供权威实时的开奖查询与高频彩票数据API接口,稳定低延迟,面向中国大陆场景的合规数据服务。。本页提供高频场景下的接口规范、认证方式、示例与合规指引,帮助你快速完成集成。

HTTPS Only
低延迟推送
签名验真

快速开始

面向“开奖查询、历史数据、走势图计算、订阅推送”的集成场景,支持 REST JSON 与 Webhook。

  1. 申请并获取 API Key(主/备),配置回调地址(可选)。
  2. 在测试环境完成连通性校验与签名验证。
  3. 根据业务选择轮询(REST)或订阅(Webhook)模式。
  4. 上线前设置限流阈值、告警与重试策略。

示例:获取最新开奖(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"
API 概览

认证与安全

  • 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 上线。

常见问题

接口用途是什么?

面向合规的信息展示、历史统计与系统集成,不提供也不引导任何投注行为。

数据延迟与一致性如何保障?

采用官方同步与多源校验机制,结合签名链路与容灾策略,确保稳定可用。

是否提供沙箱?

支持测试密钥与沙箱回调方便联调,请在申请时备注。

合规与使用规范

  • 遵循所在地法律法规,仅用于信息服务与技术开发。
  • 不得将数据用于非法或诱导性活动;不得向未成年人展示相关内容。
  • 展示数据时应标注来源与时间,不误导用户。
合规与支持

需要合规审核建议?

我们的团队可提供接入评估与展示规范指引。

预约合规咨询

技术与合规支持

如需开通密钥、对接 Webhook 或进行合规评估,欢迎与我们联系。

技术支持 合规顾问

support@11in5official.com

+86-010-8066-1155

中国北京市朝阳区建国路89号中环广场A座12层, 100022

周一至周五 09:00–18:00 (CST),周六 10:00–16:00 (CST),周日休息

北京极速11选5数据科技有限公司 · 京ICP备20250123号-1