跳转到文档内容
文档ATHubAPI 参考卷与章节
API REFERENCEATHub

上传一个卷

按小说 ID 和卷序号创建或覆盖卷标题。

PUT/api/v2/volumesREST
{ }Bodyapplication/json
示例代码
{
  "novelId": 10,
  "order": 1,
  "title": "第一卷 启程"
}

Request Body

application/json

不带查询参数:

示例代码
{
  "novelId": 10,
  "order": 1,
  "title": "第一卷 启程"
}
请求键类型必填说明
novelIdinteger是已存在的小说 ID。
orderinteger是从 1 开始的小说内卷序号,与 novelId 共同定位卷。
titlestring是去除首尾空白后不能为空。

以 (novelId, order) 新增或覆盖。不存在则创建,存在则只覆盖卷标题,保留卷 ID、创建时间和已有章节关联。 无论新增还是覆盖均返回 200;小说引用不存在返回 400。

PUT 和 GET 单条响应:

示例代码
{
  "id": 20,
  "novelId": 10,
  "order": 1,
  "title": "第一卷 启程",
  "createdAt": "2026-10-29T04:00:00Z",
  "updatedAt": "2026-10-29T04:00:00Z"
}

id 为数据库卷 ID,单章上传的 volumeId 使用此值;不是 order。 createdAt、updatedAt 为服务端时间,其他响应键与请求字段相同。 GET 列表为上述对象的数组。

正文与 JSON 示例读取自 docs/content/athub/API.md,与项目文档保持同源。
发现文档有问题?在 GitHub 提出建议 ↗