切换主题
字幕接口
此文档为憧门新番站点的字幕接口文档说明!
字幕上传
请求路由
/ako/user/upload
请求方法
POST
请求头参数
请求参数 | 请求内容 | 是否必传 | 参数类型 | 参数说明 |
---|---|---|---|---|
Authorization | Bearer ${token} | 否 | String | 身份验证 token |
Content-Type | multipart/form-data | 是 | String | 参数格式 |
请求体参数
请求参数 | 是否必传 | 参数类型 | 参数说明 |
---|---|---|---|
torrent | 是 | File | 字幕文件 |
name | 是 | String | 字幕文件名 |
aniId | 是 | String | 番剧bid-aid |
aniName | 是 | String | 番剧名 |
suberName | 是 | String | 字幕组名 |
cover | 否 | File | 字幕封面文件 |
desc | 否 | String | 字幕描述 |
响应示例
JSON
{
"msg": "字幕上传成功"
}
字幕删除
请求路由
/ako/user/torrent/:torrentId
请求方法
DELETE
请求头参数
请求参数 | 请求内容 | 是否必传 | 参数类型 | 参数说明 |
---|---|---|---|---|
Authorization | Bearer ${token} | 否 | String | 身份验证 token |
请求体参数
无
响应示例
JSON
{
"msg": "字幕删除成功"
}
字幕搜索
请求路由
/ako/search?val=公主大人&pageNum=1
请求方法
GET
请求头参数
无
请求体参数
无
响应示例 2024/12/29 字段改动
JSON
{
"subs": [
{
"id": "659d36ea78bff60b62234bc9",
"suber": {
"uid": 101,
"name": "清云字幕组",
"avatar": "/avatars/101.webp"
},
"aniBid": 443112,
"aniName": "公主大人“拷问”的时间到了",
"cover": null,
"torrent": "/torrents/443112/ddac09d941dfa58ab1266310603bb390b77a8b8c.torrent",
"torrentHash": "magnet:?xt=urn:btih:ddac09d941dfa58ab1266310603bb390b77a8b8c",
"torrentName": "[清云字幕组] 公主大人“拷问”的时间到了 第01话",
"torrentTag": "[1080P][Baha][WEB-DL][AAC AVC][CHT]",
"date": "2024-01-09 20:07:06",
"size": "497.70 MB"
}
],
"total": 1
}
字幕列表[番剧]
该接口为通过bid
查询番剧的字幕组及字幕组上传的字幕文件。
请求路由
/ako/getSub/:bid
请求方法
GET
请求头参数
无
请求体参数
无
响应示例 2024/12/29 字段改动
JSON
{
"subers": [ // 字幕组
{
"uid": 101,
"name": "清云字幕组",
"avatar": "/avatars/101.webp"
}
],
"torrents": { // 字幕文件
"110": [ // 字幕组id
{
"id": "659d36ea78bff60b62234bc9", // 字幕id
"suber": {
"uid": 101,
"name": "清云字幕组",
"avatar": "/avatars/101.webp"
},
"aniBid": 443112,
"aniName": "公主大人“拷问”的时间到了",
"cover": null,
"torrent": "/torrents/443112/ddac09d941dfa58ab1266310603bb390b77a8b8c.torrent",
"torrentHash": "magnet:?xt=urn:btih:ddac09d941dfa58ab1266310603bb390b77a8b8c",
"torrentName": "[清云字幕组] 公主大人“拷问”的时间到了 第01话",
"torrentTag": "[1080P][Baha][WEB-DL][AAC AVC][CHT]",
"date": "2024-01-09 20:07:06",
"size": "497.70 MB"
}
]
}
}
字幕列表[字幕组]
请求路由
/ako/getSubs?pageNum=${pageNum}
请求方法
GET
请求头参数 2024/12/27 新增请求头
请求参数 | 请求内容 | 是否必传 | 参数类型 | 参数说明 |
---|---|---|---|---|
Authorization | Bearer ${token} | 是 | String | 身份验证 token |
请求体参数
无
响应示例 2024/12/23 字段改动
JSON
{
"subs": [
{
"id": "659d36ea78bff60b62234bc9",
"suber": {
"uid": 101,
"name": "清云字幕组",
"avatar": "/avatars/101.webp"
},
"aniBid": 443112,
"aniName": "公主大人“拷问”的时间到了",
"cover": null,
"torrent": "/torrents/443112/ddac09d941dfa58ab1266310603bb390b77a8b8c.torrent",
"torrentHash": "magnet:?xt=urn:btih:ddac09d941dfa58ab1266310603bb390b77a8b8c",
"torrentName": "[清云字幕组] 公主大人“拷问”的时间到了 第01话",
"torrentTag": "[1080P][Baha][WEB-DL][AAC AVC][CHT]",
"date": "2024-01-09 20:07:06",
"size": "497.70 MB"
}
],
"total": 1
}
字幕组订阅
请求路由
/ako/user/sub/:uid
请求方法
GET
请求头参数
请求参数 | 请求内容 | 是否必传 | 参数类型 | 参数说明 |
---|---|---|---|---|
Authorization | Bearer ${token} | 是 | String | 身份验证 token |
请求体参数
无
响应示例
JSON
{
"msg": "订阅成功"
}
字幕组取消订阅
请求路由
/ako/user/unsub/:uid
请求方法
GET
请求头参数
请求参数 | 请求内容 | 是否必传 | 参数类型 | 参数说明 |
---|---|---|---|---|
Authorization | Bearer ${token} | 是 | String | 身份验证 token |
请求体参数
无
响应示例
JSON
{
"msg": "取消订阅成功"
}
字幕组订阅列表
请求路由
/ako/user/subList
请求方法
GET
请求头参数
请求参数 | 请求内容 | 是否必传 | 参数类型 | 参数说明 |
---|---|---|---|---|
Authorization | Bearer ${token} | 是 | String | 身份验证 token |
请求体参数
无
响应示例
JSON
[
{
"uid": 101,
"name": "清云字幕组",
"avatar": "/avatars/101.webp",
"date": "2024-01-01 20:07:06",
}
]