API 概览
SG飞艇 数据API面向对接应用、数据看板与风控系统,提供通用JSON结构、标准时间戳与可选统计扩展,便于二次计算与可视化。
实时通道
秒级同步与去重机制,保障每期数据准确落地。
历史归档
多字段索引,支持按日期、期号快速检索与分页。
统计扩展
可选返回冷热、遗漏、和值与奇偶等派生字段。
数据结构(示例)
字段清晰、命名直观,便于落库与二次加工。
{
"period": "20260123085",
"open_time": 1737616800,
"numbers": [2, 7, 9, 3, 5, 6, 4, 8, 1, 10],
"sum": 45,
"big_small": ["小","大","大","小","中"],
"odd_even": ["偶","奇","奇","奇","偶"],
"source": "official_mirror",
"checksum": "b0f1c8a2",
"ext": {
"hot_cold_rank": {"1": -2, "2": +1, "3": 0},
"omission": {"1": 3, "2": 0, "3": 1}
}
}
注:时间戳为 Unix 秒;ext 为可选扩展,按需返回。
接口与参数
查询最新
- • 方法:GET
- • 资源:/api(返回最新若干期,含可选统计字段)
- • 参数:limit(默认10)、with_ext(布尔)、token(必填)
按日期检索
- • 方法:GET
- • 资源:/api?date=YYYY-MM-DD
- • 参数:page(默认1)、page_size(默认50,<=200)、token
增量拉取
- • 方法:GET
- • 资源:/api?after=period_id
- • 参数:max_items(默认100)、with_ext、token
签名验证
- • Header:X-API-KEY / X-API-SIGN
- • 签名:HMAC-SHA256(payload + ts, secret)
- • 过期:ts 容忍±30秒
速率限制与稳定性
- • 标准配额:60 req/min;突发峰值自动平滑。
- • 幂等重试:建议退避 200ms~1s,最多重试 3 次。
- • 状态页与更新:请关注站内“新闻公告”以获知维护时窗。
安全与合规
- • 仅用于信息展示、统计分析与系统监控等合规场景。
- • 请依法合规使用数据,遵守适用的地区法律法规与平台政策。
- • 建议启用IP白名单与密钥轮换,最小化权限与密钥暴露。
常见问题(FAQ)
数据延迟多少?
通常为秒级,遇到上游波动时会自动重试与去重。
时区如何处理?
统一返回 Unix 秒与 ISO8601 字符串,默认 CST(UTC+8)。
如何校验一致性?
可使用 checksum 字段对整条记录进行校验,或比对 period+numbers。
历史数据覆盖多久?
长期归档,按日期分页检索;如需扩展留存可联系支持。
联系与支持
如需技术文档、密钥开通或定制字段,请通过以下方式与我们联系:
- • 邮箱:contact@zh-sg-plan.com
- • 电话:+86-21-8023-5688
- • 办公时间:周一至周五 09:00–18:00 CST,周六 10:00–16:00 CST,周日休息
- • 地址:上海市浦东新区世纪大道100号, 上海市, 中国, 200120
服务主体:SG飞艇数据科技(上海)有限公司 · 备案:沪ICP备20240123号-1