白小姐开奖结果数据分析正式开放数据接口，12 个端点覆盖查询与统计

2026 年 10 月 1 日，白小姐开奖结果数据分析正式开放数据接口，首批提供 12 个端点，覆盖期号查询、号码反查、区间统计与和值分布四类需求。接口统一返回 JSON，附带数据版本号与生成时间，个人开发者每日可免费调用 2,000 次，方便把历史开奖记录接入自己的统计脚本。首批开放的是只读接口，写入与回调能力暂不提供，后续按需评估。

12 个端点：查询与统计分开设计

接口分为查询与统计两组。查询组有 5 个端点，负责按日期、期号、号码定位原始记录；统计组有 7 个端点，输出频次、遗漏、区间、尾数等聚合结果，两组互不干扰，便于分别限流。查询组按日期、期号与号码三条路径拆分，同一期只命中一条记录；统计组允许一次传入多个区间，单次最多覆盖 4,986 期，结果按版本号排序。

所有端点共用一套返回结构：code 表示状态，data 承载结果，meta 里写入数据版本号、查询耗时与样本期数。开发文档给出 23 个调用示例，覆盖 Python、Node.js、PHP 三种常见环境。meta 中的版本号与站内数据保持一致，脚本可以据此判断是否需要重新拉取；接口异常时 code 返回四位数字，文档列出 17 种错误码。

接口负责人周启明介绍：「我们把统计口径写进了文档，每个字段都注明计算方式。比如 average_gap 明确为『总间隔数 ÷ 出现次数』，避免不同人算出不同结果。」文档上线首周访问量 6,842 次。文档同时提供 Postman 集合与 curl 示例，导入后改掉 key 就能直接跑通，首周有 214 位开发者完成了首次调用。

限流与缓存：2,000 次免费额度怎么算

个人开发者每日免费 2,000 次，单 IP 每分钟 60 次；团队账号每日 20,000 次，并可申请提高到 100,000 次。超出额度返回 429 状态码，同时在响应头里给出重置时间。额度按自然日重置，每日 00:00 清零，未用完不累积；团队账号可提交用量说明申请临时提额，审核通常在 4 小时内完成。为了降低无效调用，接口对统计类结果做了 15 分钟缓存。缓存命中时响应头带有 X-Cache: HIT 标记，实测命中率 73.6%，平均响应时间从 96 毫秒降到 18 毫秒。

缓存键由端点、参数与口径版本共同生成，任一变化都会重新计算，不会把旧口径的结果返回给新请求；命中率与耗时每小时写入监控表，异常时自动告警。文档明确禁止把接口用于高频轮询或转售数据。系统会记录调用方、端点、时间与返回码，异常调用会先降速再封禁，封禁前发出两次邮件提醒。上线首月共处理异常调用 41 起，其中 38 起为参数错误导致的重复请求。封禁采用阶梯式策略：首次限速至每分钟 10 次，持续超限 30 分钟才临时封禁 24 小时，解封后可正常调用。

接入示例：三个常见场景

场景一，按期号取记录：一次请求返回该期的 7 个号码、和值、奇偶比与大小比。场景二，按号码反查：返回该号码近 500 期的出现期号与间隔。场景三，统计区间：返回指定期号范围内各号码的频次与排名。三个场景的请求参数与返回字段都在文档首页给出对照表，复制即可使用，不需要额外拼接；示例响应保留了真实的字段顺序与缩进。

每个示例都给出完整请求与响应，例如查询第 2026115 期，响应中的 numbers 为 6 个正码，special 为特别号码，sum 为 136，odd_even 为「4:2」，并附带数据版本 2026.10.01。示例中的数值来自 2026 年 10 月 1 日的正式库，与站内页面完全一致，可直接用于校对结果。

下一阶段计划开放 WebSocket 推送，让开发者在开奖数据更新后 3 秒内收到事件。该能力目前在内测，预计 2027 年第一季度提供测试名额 200 个，申请入口将放在接口文档首页。推送采用订阅制，开发者按端点订阅事件，断线后自动重连并补发最近 5 分钟的事件；内测名额按申请顺序发放，优先开放给已接入查询接口的账号。