开奖API文档

使用高可用、低延迟的开奖数据接口,快速对接至门户、数据看板或内部系统。SG11选5 提供高频彩票开奖查询、历史开奖数据与稳定的开奖接口/API,面向大陆用户快速获取权威开奖信息。

数据仅用于资讯与技术集成,请遵循当地法律法规与合规要求。

API illustration

快速开始

  1. 1) 获取凭据

    申请 API Key 与 Secret,用于请求认证与签名校验。

  2. 2) 配置环境

    设置基础域名与请求超时、重试策略,确保网络稳定性。

    # Base URL
    BASE_URL="https://sg11in5-vip.com/api/v1"
    TIMEOUT=5s
    RETRY=3
  3. 3) 发起鉴权请求

    在 Header 附带 X-Api-Key 与签名,校验时间戳避免重放。

  4. 4) 订阅推送

    可使用 Webhook 接收开奖结果推送,进一步降低轮询成本。

认证与请求规范

基础信息

  • Base URL:https://sg11in5-vip.com/api/v1
  • 格式:JSON(UTF-8)
  • 时区:CST (UTC+8)

鉴权 Header

X-Api-Key: <your_key>
X-Timestamp: 1700000000
X-Signature: HMAC-SHA256(signature_base)

signature_base = method + "\n" + path + "\n" + query + "\n" + body + "\n" + timestamp

限流与重试

  • 默认限流:60 req/min(按 Key)
  • 超时:5s;建议指数退避重试(最多3次)
  • 幂等:以 issue 或请求去重键确保

主要接口

获取最新开奖

GET /api/v1/sg11x5/latest

  • query:source 可选,数据源标识;with_trend 布尔
{
  "code": 0,
  "message": "ok",
  "data": {
    "game": "sg11x5",
    "issue": "20260130-089",
    "open_time": "2026-01-30T10:45:20+08:00",
    "numbers": [01,05,07,08,11],
    "source": "official",
    "checksum": "f0c2..."
  },
  "server_time": "2026-01-30T10:45:21+08:00",
  "request_id": "req_abc123"
}

历史开奖查询

GET /api/v1/sg11x5/history

  • query:date (YYYY-MM-DD)、pagepage_size≤200

按期号查询

GET /api/v1/sg11x5/issue/{issue}

  • path:{issue} 期号,例如 20260130-089

当日期次/时间表

GET /api/v1/sg11x5/schedule

  • 返回当日各期预计封盘与开奖时间,含状态字段

Webhook 订阅

POST /api/v1/webhooks/subscribe

  • body:urlevents=["sg11x5.latest"]secret
  • 推送 Header:X-Signaturesecret 进行 HMAC-SHA256 校验

错误码与重试策略

常见错误码

  • 0 成功
  • 400 参数错误
  • 401 未授权/签名校验失败
  • 404 资源不存在
  • 429 触发限流
  • 500 服务异常

建议重试

  • 对 429/5xx:指数退避(如 0.5s/1s/2s),最多 3 次
  • 对幂等查询:优先使用期号或请求唯一键
  • 记录 request_id 便于排障

安全与签名校验

请求端签名

使用 HMAC-SHA256 对 signature_base 进行签名,base 拼接方法如下:

signature_base = method + "\n" + path + "\n" + sorted_query + "\n" + body_sha256 + "\n" + timestamp
signature = hex(hmac_sha256(api_secret, signature_base))

Webhook 校验

服务端推送时,使用订阅时提供的 secret 对原始 body 计算签名:

X-Signature: hex(hmac_sha256(secret, raw_body))
事件示例:
{
  "event": "sg11x5.latest",
  "data": { ... },
  "sent_at": "2026-01-30T10:45:21+08:00",
  "id": "evt_123"
}

代码示例

cURL

ts=$(date +%s)
base="https://sg11in5-vip.com/api/v1"
path="/sg11x5/latest"
query=""
body=""
sigbase="GET
$path
$query
$(printf "%s" "$body" | sha256sum | cut -d' ' -f1)
$ts"
sig=$(printf "%s" "$sigbase" | openssl dgst -sha256 -hmac "$API_SECRET" -hex | sed 's/^.* //')

curl -sS "$base$path" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Timestamp: $ts" \
  -H "X-Signature: $sig"

PHP (示意)

$base = "https://sg11in5-vip.com/api/v1";
$path = "/sg11x5/history?date=2026-01-30";
$ts   = time();
$body = "";
$bodyHash = hash('sha256', $body);
$sigBase = "GET\n/sg11x5/history\n" . "date=2026-01-30\n$bodyHash\n$ts";
$sig = hash_hmac('sha256', $sigBase, $apiSecret);

$ch = curl_init($base . "/sg11x5/history?date=2026-01-30");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: $apiKey",
    "X-Timestamp: $ts",
    "X-Signature: $sig",
  ]
]);
$res = curl_exec($ch);

变更与稳定性

版本策略:当前接口为 v1,遵循向后兼容的非破坏性更新原则;破坏性变更将发布 v2 并提供过渡期。

可用性:核心查询接口目标可用性 ≥ 99.9%,若有计划维护或事件复盘,将在公告区发布。

查看公告与变更记录: 前往公告中心 →

常见问题

Q1:数据延迟是多少?

通常在官方发布后秒级同步,实际取决于网络与源站状态;建议结合 Webhook 推送与轻量轮询。

Q2:是否提供历史全量下载?

支持按日期分页拉取;如需批量初始化,可联系支持提供临时下载链接。

Q3:如何验证数据完整性?

响应包含 checksumrequest_id;可二次对账比对来源与期号。

Q4:商业使用合规要求?

请遵循当地法律法规,不用于诱导或违规用途;在产品中明确“数据仅供资讯参考”。

技术支持与联系

如需更高限额、专用线路或定制字段,请联系技术支持。我们在工作时段内尽快响应排障与对接需求。

  • 邮箱:support@sg11in5-vip.com
  • 电话:+86-010-68591234
  • 地址:中国北京市北京市朝阳区朝阳路88号SOHO现代城A座1206室 100020
  • 服务时间:Mon–Fri 09:00–18:00 CST; Sat 10:00–16:00 CST

温馨提示:请妥善保管 API 密钥与 Webhook secret,避免在客户端或公共仓库中泄露。

Support