把 AIHOT 接进你的 Agent

在资讯请求中加上 category，只取对应分类；不传则包含全部分类。返回条目的 category 也使用下表中的值。

1. 01
   开压缩

   curl 加 --compressed，其他客户端打开 gzip 或 br。JSON 压缩后只有原来的 1/4 到 1/8。

2. 02
   带上 ETag

   保存响应里的 ETag，下次带 If-None-Match；内容没变时返回 304，不传正文。

3. 03
   按节奏取

   资讯和热点最快一分钟一次；日报每天 08:00 后取一次，周报、月报出刊后取一次；往回翻页翻到已有的那条就停。

内容多久变一次：新资讯全天陆续进来，精选每天变几次到几十次，日报每天 08:00、周报每周一 10:00、月报每月 1 日 10:30（北京时间）各一期。同一个 IP 每分钟超过约 60 次会收到 429，请按 Retry-After 等待，不要并发重试。

# 第一次：保存响应头里的 ETag
curl --compressed -A 'aihot-api/2.0.0 aihot-actor/<actor-uuid>' -i 'https://aihot.news/api/v1/items?mode=selected&window=24h&limit=20'
# 之后最快每分钟一次，带上 ETag；返回 304 就是没变化
curl --compressed -A 'aihot-api/2.0.0 aihot-actor/<actor-uuid>' -i -H 'If-None-Match: <上次的 ETag>' 'https://aihot.news/api/v1/items?mode=selected&window=24h&limit=20'

需要往回翻页时，把 page.nextCursor 作为 cursor 传回去，翻到已经有的那条就停，不要每次把 7 天重翻一遍。

400

参数不对：按 OpenAPI 和返回的 code 修正，不要自动换成更宽的查询。cursor 无效或滑出时间窗返回 invalid_cursor，从第一页重来。

409

snapshot_required：增量没法安全续上，重新取一次完整快照。

429

请求太密：按 Retry-After 等待，不要并发重试。

5xx

指数退避，先用上次成功的结果；公开服务不承诺 SLA。

566／567

被边缘安全规则拦下（很小的 JSON）：保留 requestId，正常退避后最多再试一次，还不行就去反馈页。不要换 User-Agent 或伪装浏览器。

能匿名调用不等于所有用途都获许可：个人、公益和组织内部使用免费；对外商业产品、收费服务、代理接口或批量再分发须先取得书面授权，见公开使用规则。