OPEN API · v1

接口文档

Base URL：https://guojixinwenshijianxian.v555.org · 每分钟 60 次 · 默认每日 5000 次

鉴权

所有数据接口都需要密钥（health 除外）。密钥由站方在后台随机生成，通过以下任一方式传入：

# 方式一：查询参数
curl "https://guojixinwenshijianxian.v555.org/api/v1/digest?key=你的密钥"

# 方式二：请求头（推荐）
curl -H "X-API-Key: 你的密钥" "https://guojixinwenshijianxian.v555.org/api/v1/digest"

密钥无效返回 401，被停用返回 403，超速或超额返回 429。

端点

方法	路径	说明
GET	`/api/v1/health`	服务状态（免密钥）
GET	`/api/v1/digest`	最新一期时间线全量条目
GET	`/api/v1/items`	条目列表，支持来源 / 关键词 / 时间筛选
GET	`/api/v1/sources`	媒体源清单与今日条数
GET	`/api/v1/archive`	历史快照清单

GET /api/v1/digest

返回当前时间线（滚动保留最近 7 天）。可选参数：date=2026-11-08 只看某天；source=BBC 只看某家；limit=50 限制条数。

{
  "ok": true,
  "site": "寰序 // 国际新闻时间线",
  "generatedAt": "2026-11-08 10:52:31",
  "slot": "早间",
  "total": 128,
  "items": [
    {
      "id": "9f2c1a7b3d4e5f60",
      "source": "BBC",
      "sourceName": "BBC",
      "title": "新西兰大选胜负难料，超过95%选票已统计",
      "titleEn": "New Zealand election too close to call with over 95% of votes counted",
      "summary": "初步结果显示，两大政党得票差距不到4000票。",
      "publishedAt": "2026-11-08T09:41:00+08:00",
      "url": "https://www.bbc.com/news/..."
    }
  ],
  "quota": { "usedToday": 3, "dailyQuota": 5000 }
}

GET /api/v1/items

参数：source（媒体 ID）、q（标题/摘要关键词）、since（ISO 时间，如 2026-11-08T00:00:00）、limit（1–500，默认 100）。

curl -H "X-API-Key: 你的密钥" \
  "https://guojixinwenshijianxian.v555.org/api/v1/items?source=Reuters&q=oil&limit=20"

可用媒体 ID

ID	媒体
`AP`	美联社
`Reuters`	路透社
`RFI`	法广
`BBC`	BBC
`NYT`	纽约时报
`Bloomberg`	彭博社
`Economist`	经济学人
`DW`	德国之声
`Guardian`	卫报
`VOA`	美国之音
`RFA`	自由亚洲

返回头

X-RateLimit-Limit：每分钟限额
X-Quota-Day-Used / X-Quota-Day-Limit：今日已用 / 日额度
Access-Control-Allow-Origin: *：允许浏览器跨域调用

申请密钥

密钥由站方后台生成，可通过首页页脚或下方邮箱联系。请勿在公开代码仓库中硬编码密钥。

接口仅供个人学习与非商业聚合展示，内容版权属原媒体。