切换主题
番剧接口
此文档为憧门新番站点的评论接口文档说明!
新增评论
请求路由
/ako/user/addComment
请求方法
POST
请求头参数
请求参数 | 请求内容 | 是否必传 | 参数类型 | 参数说明 |
---|---|---|---|---|
Authorization | Bearer ${token} | 是 | String | 身份验证 token |
Content-Type | multipart/form-data | 是 | String | 参数格式 |
请求体示例
JSON
{
"bid": 443831,
"ep": 1,
"content": "这是一条一级评论",
"rootId": null, // 为空表示一级评论
"replyId": null,
"replyTo": null
}
JSON
{
"bid": 443831,
"ep": 1,
"content": "这是一条二级评论",
"rootId": "67861dbd02e65e105e481775",
"replyId": null,
"replyTo": null
}
JSON
{
"bid": 443831,
"ep": 1,
"content": "这是一条回复的二级评论",
"rootId": "67861dbd02e65e105e481775",
"replyId": "67865865657755062758fbe8", // 被回复的子评论cid
"replyTo": "清云字幕组" // 被回复的用户名
}
响应示例
JSON
{
"msg": "评论成功"
}
删除评论
请求路由
/ako/user/delComment/:cid
请求方法
DELETE
请求头参数
请求参数 | 请求内容 | 是否必传 | 参数类型 | 参数说明 |
---|---|---|---|---|
Authorization | Bearer ${token} | 是 | String | 身份验证 token |
请求体示例
无
响应示例
JSON
{
"msg": "删除成功"
}
举报评论
请求路由
/ako/repComment/:cid
请求方法
GET
请求头参数
无
请求体示例
无
响应示例
JSON
{
"msg": "举报成功"
}
评论列表
请求路由
/ako/comments
请求方法
POST
请求头参数
请求参数 | 请求内容 | 是否必传 | 参数类型 | 参数说明 |
---|---|---|---|---|
Content-Type | application/json | 是 | String | 参数格式 |
请求体示例
JSON
{
"bid": 443831,
"ep": 1,
"by": "likes",
"page": 1,
"size": 6,
"rootId": null
}
JSON
{
"bid": 443831,
"ep": 1,
"by": "likes",
"page": 1,
"size": 6,
"rootId": "67861dbd02e65e105e481775"
}
响应示例
JSON
{
"dataList": [
{
"uid": 110,
"username": "清云字幕组",
"avatar": "/avatars/110.webp",
"content": "这是一条一级评论",
"likes": 5,
"dislikes": 0,
"replyCount": 2, // 仅获取评论列表时才返回该字段
"cid": "67861dbd02e65e105e481775",
"date": "5天前",
"rootId": null
}
],
"total": 3 // 番剧对应话数的所有评论和回复数
}
JSON
{
"dataList": [
{
"uid": 110,
"username": "清云字幕组",
"avatar": "/avatars/110.webp",
"replyId": "67861dbd02e65e105e481775",
"replyTo": "清云字幕组",
"content": "这是一条回复的二级评论",
"likes": 7,
"dislikes": 0,
"cid": "67865871657755062758fbea",
"date": "8天前",
"rootId": "67861dbd02e65e105e481775"
},
{
"uid": 110,
"username": "清云字幕组",
"avatar": "/avatars/110.webp",
"replyId": null,
"replyTo": null,
"content": "这是一条二级评论",
"likes": 3,
"dislikes": 0,
"cid": "67865865657755062758fbe8",
"date": "8天前",
"rootId": "67861dbd02e65e105e481775"
}
],
"total": 2 // 对应评论的所有回复数
}