Developer · REST API v1.4.0

API

AI HOT 提供匿名只读的公开 REST API：无需 API Key，即可获取精选动态、最近 7 天公开池、AI 日报与当前热点。一个请求开始接入，严格合同以 OpenAPI 3.1 为准。

打开 OpenAPI YAML Agent 接入查看当前版本

OVERVIEW

先看清接入边界

只读、匿名、有时间窗与频率约定。适合程序、工作流和自定义 Agent，而不是浏览器伪装抓取。

API 版本

v1.4.0

公开 REST API，字段、错误码与 schema 以 OpenAPI 3.1 为准

公开端点

7个

覆盖精选、公开池、日报、热点、指纹与版本信息

鉴权方式

匿名 GET

无需 token / API Key，只允许只读访问

规范文档

OpenAPI3.1

完整合同见 openapi.yaml；本页只保留首次接入要点

CAPABILITIES

API 能帮你做什么

精选与公开池

通过 /api/public/items 读取精选动态或最近 7 天公开池，支持分类、时间窗、关键词、cursor 分页与 fields 精简模式。

日报与热点

可拉最新日报、指定日期日报、日报日期索引，以及按多源热度排序的当前热点，方便做摘要面板或定时推送。

低流量轮询

fingerprint 端点用于判断头部条目是否变化；无变更时可避免全量拉取。标题、摘要等原地编辑由 items 的 ETag / If-None-Match 感知。

带宽友好

支持 ETag / Last-Modified：无变更返回 304。fields=minimal 只保留索引与深链字段，适合通知、索引或 Agent 粗扫。

FIRST REQUEST

60 秒发起第一次调用

请把 your-app/1.0 和联系方式替换成你自己的标识；不要在生产中原样使用示例 UA，也不要伪装浏览器。

UA="your-app/1.0 (+mailto:you@example.com)"
curl -H "User-Agent: $UA" \
  'https://aihot.virxact.com/api/public/items?mode=selected&take=20'

默认精选

不传 mode 等同 selected；只有明确需要公开池时用 all。

最长 7 天

不传 since 等同 now - 7d；更早内容请查日报归档。

公开池不等于全库

不含公众号、未审内容、低相关和已合并重复条目。

保留 attribution

默认完整响应包含 AI HOT 来源和 canonical；minimal 不含该字段。

01
带可识别 UA 发起首次请求
使用非浏览器 User-Agent，并附上应用名与联系方式。不要伪装 Mozilla / Chrome / HeadlessChrome。
02
先读精选，再按需放开公开池
默认 mode=selected。公开池不等于全库：不含公众号、未审内容、低相关和已合并重复条目。
03
分钟级轮询先查 fingerprint
每分钟先查轻量指纹；只有变化时再拉 items。只做通知或索引时加 fields=minimal。
04
严格合同看 OpenAPI
页面只保留首次接入内容。字段、错误码、schema 与兼容性边界以 OpenAPI 3.1 与 changelog 为准。

ENDPOINTS

端点速览

以下为公开 GET 端点。路径相对于 https://aihot.virxact.com。

方法	路径	说明
GET	`/api/public/items`	精选或最近 7 天公开池；支持分类、时间和关键词
GET	`/api/public/hot-topics`	当前热点，按多源热度排序
GET	`/api/public/daily`	最新日报
GET	`/api/public/daily/{date}`	指定日期日报
GET	`/api/public/dailies`	日报日期索引
GET	`/api/public/fingerprint`	低流量轮询指纹
GET	`/api/public/version`	API 与 Skill 版本

ITEMS PARAMS

items 查询参数

/api/public/items 是最常用的列表接口。参数不合法时返回 400，请按 OpenAPI 修正，不要自动放宽查询。

参数	默认	用途与边界
`mode`	selected	selected \| all；不传等同 selected，只有明确需要公开池时用 all
`since`	now - 7d	ISO 8601；早于 7 天会截断，更早内容请查日报归档
`take`	50	整数 1–100
`category`	无	ai-models / ai-products / industry / paper / tip
`q`	无	关键词，2–200 字
`cursor`	无	原样回传 nextCursor，不要解析
`fields`	default	minimal 仅保留索引和深链字段

POLLING

分钟级轮询：先 fingerprint，再拉 items

fingerprint 只判断头部条目是否变化；标题、摘要或分类的原地编辑由 items 的 ETag / If-None-Match 感知。

# 每分钟先查轻量指纹；只有变化时才拉 items
curl -H "User-Agent: $UA" \
  'https://aihot.virxact.com/api/public/fingerprint'

# 只做通知或索引时使用轻量字段
curl -H "User-Agent: $UA" \
  'https://aihot.virxact.com/api/public/items?mode=selected&take=50&fields=minimal'

ERRORS

错误与恢复

400

参数不合法；按 OpenAPI 修正，不要自动改成宽查询。

403

检查是否使用了可识别的非浏览器 User-Agent。

567 / blocked

边缘安全规则在请求到达 AI HOT 前拦截；不等于 IP 被封。移除浏览器 UA，旧 Skill 先更新，再只重试一次；仍失败请提交 requestId。

429

退避 30–60 秒；不要增加并发重试。

5xx / 超时

指数退避，并使用上次成功缓存；测试版不提供 SLA。

GUARDRAILS

使用边界：公开可读，不等于可以忽略来源

重要事实回原文核对

摘要和翻译由 AI 生成。引用数字、政策或原话前，请使用 API 返回的原文 URL 复核。

保留来源和 canonical

对外发布 API 结果时请保留返回的 attribution / canonical；第三方原文版权归原作者。minimal 响应默认不含 attribution 字段。

按频率合同调用

正常会话、RSS 阅读器和分钟级轮询均可使用；收到 429 后退避 30–60 秒，不要增加并发重试。

测试版，不提供 SLA

兼容性变化和版本更新会写入 changelog；生产关键链路请自行设置缓存、重试和降级。

USE CASES

典型接入场景

自定义仪表盘

程序化接入精选、热点与日报，构建团队内部 AI 动态看板或晨会摘要。

工作流与低代码

把 API 接到自动化工具，按分类或关键词触发通知、归档或二次筛选。

自建 Agent

让自定义 Agent 通过结构化接口获取 AI 行业新闻；若使用支持 Skills 的平台，也可直接安装 Agent Skill。

OpenAPI YAML

完整接口合同、字段与错误码。

打开规范

当前版本

查询 API 与 Skill 版本信息。

查看 version

Agent 接入

Agent Skill、RSS 与 REST API 的统一接入页。

打开 Agent 页

精选 RSS

阅读器或低代码场景可先用 RSS，再升级到 API。

订阅精选

FAQ

常见问题

AI HOT API 需要申请 Key 吗？

不需要。公开 REST API 为匿名只读，只允许 GET；无需 token / API Key。请使用可识别的非浏览器 User-Agent，并在生产环境替换示例中的应用名与联系方式。

API 能拿到哪些数据？

可访问精选内容、最近 7 天公开池、最新/指定日期日报、日报日期索引、当前热点、轮询指纹，以及 API 与 Skill 版本信息。共 7 个公开端点。

selected 和 all 有什么区别？

mode 默认 selected，对应精选。all 为最近 7 天公开池，不等于全库，也不含公众号、未审内容、低相关和已合并重复条目。更早内容请查日报归档。

如何减少无效请求？

分钟级轮询先请求 /api/public/fingerprint；无变化则不必拉 items。items 支持 ETag / If-None-Match，无变更返回 304。仅需索引或通知时使用 fields=minimal。

遇到 blocked / 567 怎么办？

这通常表示边缘安全规则拦截，不等于 IP 被封。请移除 Mozilla、Chrome、HeadlessChrome 等浏览器 UA，改用可识别非浏览器 UA 后只重试一次；旧 Agent Skill 请先更新。仍失败时在反馈中附上 requestId。

可以二次分发 API 结果吗？

公开可读不等于可以忽略来源。对外发布时请保留返回的 attribution / canonical；第三方原文版权归原作者。引用关键事实前请回原文 URL 核对。

AI HOT API

把 AI 行业动态接进你的程序

打开 OpenAPI 查看完整合同，或前往 Agent 接入页选择 Skill / RSS / REST 最合适的路径。接入失败、Skill 漏触发或需要新端点，可通过反馈页联系；也可发邮件至wzglyay@virxact.com。

打开 OpenAPI YAML 反馈

API