寰序 // 财经时政看点

数据接口 / Open API

把本站每日财经时政摘要以 JSON 形式接入你自己的程序、机器人或看板。接口仅返回已整理好的新闻与 AI 解读，不含图片与附件。

一、获取密钥

密钥由站方在后台生成，形如 hx_ 开头的一串字符。每个密钥可单独设置每日额度，可随时停用或删除。

调用时三选一携带密钥：

方式示例
请求头 X-API-Key（推荐）X-API-Key: hx_xxxxxxxx
Authorization BearerAuthorization: Bearer hx_xxxxxxxx
URL 参数?key=hx_xxxxxxxx

二、接口列表

1. 最新状态 GET

/api/v1/latest

返回最近一次更新时间与各栏目条数，适合做健康检查。

curl -H "X-API-Key: 你的密钥" https://caijingxinwen.v555.org/api/v1/latest
{"ok":true,"updatedAt":"2026-11-07 21:30:00","counts":{"global":20,"asia":10,"china":10,"earnings":10},"total":50,"aiEnabled":true,"aiModel":"deepseek-v4.1-flash-1017"}

2. 完整日报 GET

/api/v1/daily

一次取回全部栏目与全部条目，字段最全，适合做「每日推送」。

curl -H "X-API-Key: 你的密钥" https://caijingxinwen.v555.org/api/v1/daily
{
  "ok": true,
  "site": "寰序 // 财经时政看点",
  "updatedAt": "2026-11-07 21:30:00",
  "global": {"label": "国际财经", "items": [
    {"id":"a1b2c3d4e5f60718","title":"…","summary":"…","source":"CNBC",
     "url":"https://…","publishedAt":"2026-11-07 19:20",
     "analysis":"…","coreLogic":"…","impact":"…","risk":"…"}
  ]},
  "asia": {"label": "亚太财经", "items": []},
  "china": {"label": "国内财经", "items": []},
  "earnings": {"label": "核心财报", "items": []},
  "counts": {"global":20,"asia":10,"china":10,"earnings":10}
}

3. 按栏目取新闻 GET

/api/v1/news

参数说明
channel栏目：global（国际财经）、asia（亚太财经）、china（国内财经）、earnings（核心财报）；不传则返回全部栏目
limit每个栏目最多返回条数，1–50，默认 20
q关键词过滤，匹配标题、摘要、来源与 AI 解读
ai传 1 时只返回带 AI 深度解读的条目
curl -H "X-API-Key: 你的密钥" \
  "https://caijingxinwen.v555.org/api/v1/news?channel=china&limit=5&ai=1"

4. 栏目清单 GET

/api/v1/channels —— 返回栏目 key、名称与条数上限。

三、字段说明

字段说明
id条目稳定标识（由原文链接生成），可用于去重
title中文标题
summary中文摘要
source媒体来源
url原始报道链接
publishedAt发布时间（北京时间）
analysisAI 简评（并非每条都有）
coreLogic核心逻辑
impact潜在市场影响
risk风险与不确定性

四、调用规则

限流单密钥默认每分钟 60 次，超出返回 429。

额度可按天设置调用上限，0 表示不限。

缓存建议本地缓存 10 分钟以上，数据每 2 小时更新一次，频繁拉取不会更快。

跨域已开放 CORS，可在网页前端直接调用。

错误状态码

状态码含义
401缺少密钥或密钥无效
403密钥已停用
429超出频率限制或当日额度
503站方暂停 API 服务

五、调用示例

Python

import requests

r = requests.get(
    "https://caijingxinwen.v555.org/api/v1/news",
    params={"channel": "global", "limit": 10},
    headers={"X-API-Key": "你的密钥"},
    timeout=20,
)
for item in r.json()["data"]["global"]:
    print(item["title"], item["url"])

JavaScript（浏览器）

const res = await fetch(
  "https://caijingxinwen.v555.org/api/v1/latest",
  { headers: { "X-API-Key": "你的密钥" } }
);
console.log(await res.json());