双色球接入指导（lottery_ssq）¶

相关页：数据源目录 · 设备接入手册

1. 用途¶

在设备端展示最新一期中国福利彩票双色球开奖结果：红球（6 个）、蓝球（1 个）、奖池金额与当前在售期号。开奖日（周二/四/日）21:30 服务端自动预热，设备整点轮询即得最新数据。

2. 端点与鉴权¶

GET https://api.wwzu.com/api/v1/data/lottery_ssq
X-Device-SN: XMBOX-2026-000001
X-Device-Token: <device_token>

设备鉴权：请求头 X-Device-SN + X-Device-Token（获取方式见设备接入手册 · 鉴权）；
需订阅：用户须在用户中心「数据源订阅」页开通本源，未开通返回 40302；
可带 ?version=v1 取指定版本，缺省取最新已上线版本。

3. 请求参数¶

无业务参数。

4. 返回示例¶

{
  "code": 0,
  "msg": "success",
  "data": {
    "source": "lottery_ssq",
    "version": "v1",
    "updated_at": "2026-08-30 21:35:00",
    "stale": false,
    "payload": {
      "period": "2026098",
      "date": "2026-08-30",
      "red": [3, 9, 14, 22, 26, 31],
      "blue": 11,
      "pool_amount": "",
      "sale_period": "2026102",
      "source_name": "数据来自中国福利彩票官网，仅供信息展示，不构成任何投注建议"
    }
  },
  "server_time": 1788000000
}

字段	类型	说明
`period`	string	期号，如 `2026098`
`date`	string	开奖日 `YYYY-MM-DD`
`red`	int[6]	红球，升序、不重复、1~33
`blue`	int	蓝球 1~16
`pool_amount`	string	奖池（元，千分位）；上游未提供时为空串
`sale_period`	string	在售期号（正在销售、尚未开奖；无则为空串）
`source_name`	string	来源标注（必展示）

5. 注意事项¶

缓存：TTL 1800 秒、全设备共享；开奖日 21:30 cron 预热（30 21 * * 2,4,0，北京时间），updated_at 即开奖数据时间；
合规：source_name 免责文案固化在响应中，设备端展示时必须保留；
pool_amount / sale_period 上游未提供时为空串，设备端按空处理、勿报错；
错误处理：40302（未订阅）、42901（限流，按 retry_after 退避）、50401（上游失败且无缓存，保留上次画面）——完整语义见错误码总表。