# NewsBing

> 热点公开可读，无需登录、Cookie、Authorization 请求头或 API Key。

## 接入文档

- [Agent 接入文档](/agent.md)：免鉴权的完整 Markdown 说明，包含公开热点、资讯鉴权、请求示例、字段和错误处理。请先阅读此文档。
- [HTML 接入说明](/docs)：面向人的 AI 热点 API 使用步骤、字段和免 Key 示例。
- [Agent 接入页面](/?view=agent)：面向人的说明与个人 Key 管理，说明公开可见，创建 Key 需要登录。

## 读取热点

- [公开热点 JSON](/api/public/hotspots)：使用普通 HTTP GET 即可读取，无需浏览器或执行 JavaScript。
- [热点网页](/?view=hotspots)：供浏览器交互阅读；初始 HTML 不包含榜单，请使用上面的 JSON 入口。

JSON 字段：
- aggregate.items：AI 聚合总榜；每项含 title、platforms、sources（原始标题与来源链接）。
- aggregate.updatedAt：总榜最近成功更新时间；stale、hasError 表示数据较旧或更新异常。
- items：各平台榜单；含 title、url、summary、sourceId、sourceLabel、platform、rank、capturedAt。
- sources：各榜单采集状态；含 lastFetchedAt、hasError、availability。

内容为已存快照；读取不会启动采集或 AI 任务。空榜、旧数据和来源缺失应按原样说明，不视为实时全量新闻。建议轮询间隔至少 5 分钟。

## 需要授权的内容

资讯、个人内容和管理功能沿用各自权限。/api/v1/* 是需要 API Key 的正式接口；只阅读公开热点请使用 /api/public/hotspots。