PUT
/api/v2/volumesREST{ }Bodyapplication/json
{
"novelId": 10,
"order": 1,
"title": "第一卷 启程"
}Request Body
application/json不带查询参数:
{
"novelId": 10,
"order": 1,
"title": "第一卷 启程"
}| 请求键 | 类型 | 必填 | 说明 |
|---|---|---|---|
novelId | integer | 是 | 已存在的小说 ID。 |
order | integer | 是 | 从 1 开始的小说内卷序号,与 novelId 共同定位卷。 |
title | string | 是 | 去除首尾空白后不能为空。 |
以 (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 提出建议 ↗