寰序 // 极减新闻

开放 API

每日精选日报可被程序读取。鉴权用 API Key，密钥在管理后台随机生成、随时吊销。

鉴权方式

在请求头带上密钥，也支持 ?api_key= 查询参数（不建议用于公开前端）。

curl "https://jijianxinwen.v555.org/api/v1/daily" \
  -H "X-API-Key: jk_你的密钥"

接口清单

GET每日日报

/api/v1/daily

参数：date（YYYY-MM-DD，缺省为最新一天）、limit（默认 50，最多 200）、category、min_score。返回当天全部精选，含排名、分数、摘要、原文链接。

GET指定日期日报

/api/v1/daily/{date}

例：/api/v1/daily/2026-11-08。返回该日全部可见新闻，按重要性降序。

GET新闻检索

/api/v1/news

参数：q 关键词、category 分类、date 日期、page/limit 分页。适合做搜索与二次聚合。

GET单条详情

/api/v1/news/{id}

用条目 id 取单条，返回结构同列表元素。

GET分类统计

/api/v1/categories

返回各分类的收录条数。

GET总体统计

/api/v1/stats

返回总量、今日数据、最近 30 天日期列表。

返回示例

{
  "ok": true,
  "data": {
    "date": "2026-11-08",
    "count": 16,
    "stats": { "count": 16, "max_score": 8.7, "avg_score": 6.4, "sources": 9 },
    "items": [
      {
        "rank": 1,
        "id": "9f2c1a7b3d4e5f60",
        "title": "标题",
        "brief": "一句话摘要",
        "score": 8.7,
        "category": "财经",
        "source": "Google News 财经",
        "url": "https://...",
        "published_at": "2026-11-08 09:12:00"
      }
    ],
    "attribution": "寰序 // 极减新闻 · 一杯咖啡满电出发"
  }
}

限额与约定

每个密钥默认每分钟 60 次、每日 1000 次，可在后台按密钥单独调整。超限返回 429。调用时请保留来源署名与原文链接，不要整站镜像后去掉出处。