数据源目录¶
设备可消费的全部在线数据源索引页:只做导航与概述。每个数据源均有独立的接入指导页(用途 / 端点与鉴权 / 请求参数 / 返回示例 / 注意事项);统一取数路径 GET /api/v1/data/{source_code} 与设备鉴权见设备接入手册。
合规声明
彩票类数据源仅展示官方公开开奖结果;全链路无投注、预测、导流内容;source_name 免责文案固化在响应中,设备端展示时必须保留。
在线数据源(5 个)¶
| 数据源 | code | 简介 | 订阅 | 接入指导 |
|---|---|---|---|---|
| 双色球 | lottery_ssq |
最新期红蓝球、奖池与在售期号,开奖日 21:30 预热 | 需订阅 | 接入指导 → |
| 超级大乐透 | lottery_dlt |
最新期前区/后区号码与销售期号,开奖日 21:30 预热 | 需订阅 | 接入指导 → |
| 整点新闻播报 | news_hourly |
每日 9:00~22:00 共 14 档:多源聚合 → 大模型播客化整理 → TTS 合成 | 需订阅 | 接入指导 → |
| 电台转播 | radio_relay |
国内电台 MP3 直连台,纯实时流式收听(网页/手机/播放器/设备) | 需订阅 | 接入指导 → |
| 听老故事 | comic_audio |
连环画语音整本连播:标签 → 故事 → 播放清单 | 付费源(邀请码开通) | 接入指导 → |
库内 VIP 设备免开通(2026-09-19)
出厂预导入(管理员 SN 批量入库)的设备为 VIP 设备:绑定后全部数据源直接可用(含付费源),无需订阅、设备端清单自动全量可见;开放模式自行注册的设备不在此列,付费源仍需邀请码开通(见 FAQ)。
通用约定(各源一致):
payload序列化 < 4KB、列表 ≤ 10 条、展示文本单条 ≤ 30 字,字段名同版本内只增不改;- 需订阅的源未开通时返回
40302;限流默认 10 次/分/设备/源(42901退避); - 响应统一信封与
stale降级语义见设备接入手册。
另有
weather_basic(基础天气)为插件开发示例源,仅用于演示插件规范的最小实现(见插件开发指南),生产环境未部署、不在上方清单内。
版本与日落策略¶
- 请求可带
?version=vN取指定版本;缺省取最新已上线版本; - 版本废弃后调用仍正常返回,但
msg附带“该版本将于 {sunset_at} 下线,请升级”;到期后返回50302; - 数据源停用/维护返回
50301;清单接口GET /api/v1/data/sources只返回当前可用源。