公开 API

调试与常见问题

一行 curl 调试 + RSS 接入常见问题解答。

调试快查

前 3 个 item

curl -s 'https://anibt.net/rss/anime.xml?bgmId=543360&groupSlug=kirara-fantasia&limit=3' \
  | grep -E '<title>|<pubDate>'

ETag 复用

H=$(curl -sI 'https://anibt.net/rss/anime.xml?bgmId=543360')
echo "$H" | grep -iE 'etag|last-modified'
ETAG=$(echo "$H" | grep -i '^etag:' | cut -d' ' -f2- | tr -d '\r')
curl -sI -H "If-None-Match: $ETAG" 'https://anibt.net/rss/anime.xml?bgmId=543360' | head -1

全部字幕组

curl -s https://anibt.net/api/subtitle-groups \
  | jq '.data[] | {name, slug, totalReleases}'

按名字过滤

curl -s https://anibt.net/api/subtitle-groups \
  | jq '.data[] | select(.name | test("Kirara Fantasia|Prejudice-Studio|北宇治字幕组|拨雪寻春")) | {name, slug}'

常见问题

接入 checklist

最后过一遍：

启动时拉一次 `/api/subtitle-groups`

本地缓存 name → slug 映射，避免硬编码 slug。

用 `/rss/anime.xml` 或短链订阅

优先 bgmId + groupSlug 组合；不需要过滤时用 /rss/group/<slug>.xml。

永远带 If-None-Match

缓存上次响应的 ETag，下次请求带 If-None-Match，详见 HTTP 缓存与 304。

间隔 ≥ 5 分钟

更短没收益，且容易触发 429。

见 429 用 Retry-After 退避

不要立即重试。

限流与上限

各端点的 limit、候选扫描上限、速率限制、客户端兼容矩阵与延迟拆解。

LLM 对接

AniBT Wiki 提供 llms.txt、llms-full.txt 与每页 Markdown 端点，方便外部 LLM / Agent / RAG 系统抓取整站内容做问答与代码生成。

本页目录

调试快查常见问题接入 checklist 启动时拉一次 /api/subtitle-groups用 /rss/anime.xml 或短链订阅永远带 If-None-Match 间隔 ≥ 5 分钟见 429 用 Retry-After 退避