快速开始
-
1) 获取凭据
申请 API Key 与 Secret,用于请求认证与签名校验。
-
2) 配置环境
设置基础域名与请求超时、重试策略,确保网络稳定性。
# Base URL BASE_URL="https://sg11in5-vip.com/api/v1" TIMEOUT=5s RETRY=3 -
3) 发起鉴权请求
在 Header 附带 X-Api-Key 与签名,校验时间戳避免重放。
-
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)、page、page_size≤200
按期号查询
GET /api/v1/sg11x5/issue/{issue}
- path:{issue} 期号,例如 20260130-089
当日期次/时间表
GET /api/v1/sg11x5/schedule
- 返回当日各期预计封盘与开奖时间,含状态字段
Webhook 订阅
POST /api/v1/webhooks/subscribe
- body:url、events=["sg11x5.latest"]、secret
- 推送 Header:X-Signature 用 secret 进行 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:如何验证数据完整性?
响应包含 checksum 与 request_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,避免在客户端或公共仓库中泄露。