diff --git a/docs/api.md b/docs/api.md index 9794f7b..dc9d351 100644 --- a/docs/api.md +++ b/docs/api.md @@ -245,6 +245,16 @@ pdf / 单图没有独立目录,回落到 items。 响应与 `/content` 一致,但 `ETag` 是按文件而非按书。 +### `GET /books/:id/file?path=` + +流式返回这本书的**某一个**文件。 + +只有一种格式需要它:以图片目录形式存放的漫画。这种情况没有一个「书文件」可以整体 +下载,客户端按页取。`path` 必须是这本书已经登记过的 `rel_path`—— +服务端按 `book_files` 表精确匹配,不会用 query 拼路径,所以路径穿越只会匹配到空。 + +响应与 `/content` 一致,但 `ETag` 是按文件而非按书。 + ### `GET /books/:id/cover` 返回封面。无封面时 `404 NO_COVER`。缓存头是 `immutable`(封面随书籍主键变化)。