Skip to content
本页目录

字幕接口

此文档为憧门新番站点的字幕接口文档说明!

字幕上传

请求路由

/ako/user/upload

请求方法

POST

请求头参数
请求参数请求内容是否必传参数类型参数说明
AuthorizationBearer ${token}String身份验证 token
Content-Typemultipart/form-dataString参数格式
请求体参数
请求参数是否必传参数类型参数说明
torrentFile字幕文件
nameString字幕文件名
aniIdString番剧bid-aid
aniNameString番剧名
suberNameString字幕组名
coverFile字幕封面文件
descString字幕描述
响应示例
JSON
{
  "msg": "字幕上传成功"
}

字幕删除

请求路由

/ako/user/torrent/:torrentId

请求方法

DELETE

请求头参数
请求参数请求内容是否必传参数类型参数说明
AuthorizationBearer ${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 新增请求头
请求参数请求内容是否必传参数类型参数说明
AuthorizationBearer ${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

请求头参数
请求参数请求内容是否必传参数类型参数说明
AuthorizationBearer ${token}String身份验证 token
请求体参数

响应示例
JSON
{
  "msg": "订阅成功"
}

字幕组取消订阅

请求路由

/ako/user/unsub/:uid

请求方法

GET

请求头参数
请求参数请求内容是否必传参数类型参数说明
AuthorizationBearer ${token}String身份验证 token
请求体参数

响应示例
JSON
{
  "msg": "取消订阅成功"
}

字幕组订阅列表

请求路由

/ako/user/subList

请求方法

GET

请求头参数
请求参数请求内容是否必传参数类型参数说明
AuthorizationBearer ${token}String身份验证 token
请求体参数

响应示例
JSON
[
  {
    "uid": 101,
    "name": "清云字幕组",
    "avatar": "/avatars/101.webp",
    "date": "2024-01-01 20:07:06",
  }
]