hongguo-linux API 文档

鉴权：除 /、/health、/openapi.json、/docs 外，都要 Authorization: Bearer <API_TOKEN>。完整机器可读版见 /openapi.json。

发现

GET  /api/browse/categories
GET  /api/browse?category=real-drama&genre=fantasy&page=1
GET  /api/search?keyword=太奶
POST /api/series/resolve   {"input": "分享链接或纯数字 series_id"}

下载 / 合并（异步）

POST /api/jobs   {"series_id":"7701935931787316286","episodes":"1","merge":true}
→ 202 {"job_id":"...","status":"queued"}
GET  /api/jobs
GET  /api/jobs/:id
GET  /api/jobs/:id/file
DELETE /api/jobs/:id
POST /api/jobs   {"series_id":"...","episodes":"1-10","merge":true,"type":"merge"}
→ 只合并已下载的分集，不重新下载

选集语法：1-50、1-10, 25, 30-45、all。n8n 只做编排：建任务后轮询 GET /api/jobs/:id，或等 CALLBACK_URL 回调，不要同步等下载。

资料库 / 关注

GET  /api/library
GET  /api/library/:series_id
GET  /api/watch
POST /api/watch   {"series_id":"..."}
POST /api/watch/:series_id/check
DELETE /api/watch/:series_id

状态

GET /health
GET /api/status

注意：搜索页 2026-11-11 真浏览器核查：先显示骨架屏，约 15 秒后渲染出结果，“太奶”第 1 页 10 张卡，分页到 21 页；plain HTTP 只返回 JS 脚本页、没有卡片。本项目搜索接口空结果时如实返回 + 提示，优先用分类浏览发现剧。搜索卡片不标总集数，总集数以 resolve 的结果为准。