寰序 // 丰富版日报
API REFERENCE · v1

日报数据 API

把《寰序 // 丰富版日报》的日报、4 小时简报与行情提醒接入你自己的系统。全部接口返回 JSON,需在请求头携带 API 密钥;密钥在管理后台随机生成,可随时停用。

1 · 鉴权

在请求头中带上 X-API-Key(也支持 Authorization: Bearer 密钥 或查询参数 ?apikey=):

X-API-Key: hx_你的密钥
密钥由后台「API 密钥」页生成,仅显示给管理员。默认单密钥每分钟 60 次、每日 5000 次,超限返回 429。同一个密钥可绑定一个调用方,便于分别限流与统计。

2 · 接口一览

方法路径说明
GET/api/v1/health免密钥服务健康检查
GET/api/v1/daily/latest最新一期丰富版日报;加 ?full=1 返回全文纯文本
GET/api/v1/daily/list日报列表,?limit=30(上限 100)
GET/api/v1/daily/<date>按日期取,如 /api/v1/daily/2026-11-07,可加 ?full=1
GET/api/v1/briefs/latest最新一期 4 小时简报,可加 ?full=1
GET/api/v1/briefs/list简报列表
GET/api/v1/alerts/list行情提醒列表
GET/api/v1/index一次性取日报 / 简报 / 提醒的最新若干条
GET/api/v1/search标题与摘要关键词检索:?q=黄金

3 · 调用示例

curl

curl -s -H "X-API-Key: hx_你的密钥" \
  "https://fengfuribao.v555.org/api/v1/daily/latest?full=1"

Python

import requests

HEADERS = {"X-API-Key": "hx_你的密钥"}
r = requests.get("https://fengfuribao.v555.org/api/v1/daily/latest",
                 headers=HEADERS, params={"full": 1}, timeout=15)
data = r.json()["data"]
print(data["date"], data["title"])
print(data["content"][:500])

JavaScript

const res = await fetch("https://fengfuribao.v555.org/api/v1/index?limit=5", {
  headers: { "X-API-Key": "hx_你的密钥" }
});
const { data } = await res.json();
console.log(data.daily[0].title, data.daily[0].url);

4 · 返回结构

{
  "ok": true,
  "site": "寰序 // 丰富版日报",
  "generatedAt": "2026-11-08 09:50:00",
  "data": {
    "id": 12,
    "kind": "daily",
    "date": "2026-11-08",
    "time": "07:10",
    "title": "11月08日 丰富版日报",
    "summary": "本期要点:…",
    "url": "https://fengfuribao.v555.org/daily/daily_report_rich_2026-11-08.html",
    "content": "全文纯文本(仅 full=1 时返回)",
    "length": 18342
  }
}

出错时返回 HTTP 状态码与 {"ok": false, "error": "原因"}:401 缺密钥/密钥无效、403 密钥停用、429 超额或超频、404 无对应内容、503 API 已关闭。

5 · 使用约定

项目说明
数据更新日报每日 07:10 生成;简报在 03:31 / 07:31 / 11:31 / 15:31 / 19:31 / 23:31 更新(上海时间)
缓存建议同一期内容不会变动,建议按 date 本地缓存 30 分钟以上
转载请保留原文链接与「© 2026 一杯咖啡满电出发//丰富版日报」署名
申请密钥联系站点管理员,在后台为你单独生成