Skip to content

episode_admin

PlentyMore edited this page Jul 11, 2018 · 3 revisions

剧集管理

  • 获取剧集信息

GET /admin/episodes

参数

Name Type Description
pageNum Integer 页码
pageSize Integer 页大小

请求示例

  1. GET /admin/episodes

  2. GET /admin/episodes?pageNum=1

  3. GET /admin/episodes?pageNum=1&pageSize=30

返回数据

{
    "code": 0,
    "msg": "OK",
    "data": {
        "episodes": [
            {
                "epId": 246,
                "epIndex": 1,
                "bangumiId": 196,
                "replyable": 1,
                "createTime": 1529295653000,
                "modifyTime": 1529295653000,
                "danmakuId": "6f79c2e08b454e64a37bb0ab1ef8b958"
            },
            {
                "epId": 247,
                "epIndex": 1,
                "bangumiId": 197,
                "replyable": 1,
                "createTime": 1529295656000,
                "modifyTime": 1529295656000,
                "danmakuId": "2fdd3bda77134c15b3bc1dee8db06f59"
            },
            {
                "epId": 248,
                "epIndex": 1,
                "bangumiId": 198,
                "replyable": 1,
                "createTime": 1529295660000,
                "modifyTime": 1529295660000,
                "danmakuId": "7f257fec520341daa42ff53dbfdc2309"
            },
            {
                "epId": 249,
                "epIndex": 1,
                "bangumiId": 199,
                "replyable": 1,
                "createTime": 1529295665000,
                "modifyTime": 1529295665000,
                "danmakuId": "3dd497ce4f4b4f3798fe4fb4dfd8e272"
            },
            {
                "epId": 250,
                "epIndex": 1,
                "bangumiId": 200,
                "replyable": 1,
                "createTime": 1529295670000,
                "modifyTime": 1529295670000,
                "danmakuId": "52f4296bae4e46debb43b1e20abd1e3c"
            },
            {
                "epId": 251,
                "epIndex": 1,
                "bangumiId": 201,
                "replyable": 1,
                "createTime": 1529295674000,
                "modifyTime": 1529295674000,
                "danmakuId": "8a592f60ab0246859ecff6cf30e5d32a"
            },
            {
                "epId": 252,
                "epIndex": 1,
                "bangumiId": 202,
                "replyable": 1,
                "createTime": 1529295678000,
                "modifyTime": 1529295678000,
                "danmakuId": "01f9e80561064f71ac90da79be57dc06"
            },
            {
                "epId": 253,
                "epIndex": 1,
                "bangumiId": 203,
                "replyable": 1,
                "createTime": 1529295682000,
                "modifyTime": 1529295682000,
                "danmakuId": "09246a4f716047f99c12f63ee50f60e3"
            },
            {
                "epId": 254,
                "epIndex": 1,
                "bangumiId": 204,
                "replyable": 1,
                "createTime": 1529295686000,
                "modifyTime": 1529295686000,
                "danmakuId": "0a8ba5e2b44a421eaf5aab062c655994"
            },
            {
                "epId": 255,
                "epIndex": 1,
                "bangumiId": 205,
                "replyable": 1,
                "createTime": 1529295694000,
                "modifyTime": 1529295694000,
                "danmakuId": "279ec7fc30dc4cb59f534a4867efba75"
            },
            {
                "epId": 245,
                "epIndex": 1,
                "bangumiId": 195,
                "replyable": 1,
                "createTime": 1529295648000,
                "modifyTime": 1529295648000,
                "danmakuId": "ca9299b4e8d44282b9e41533e6222a18"
            },
            {
                "epId": 217,
                "epIndex": 1,
                "bangumiId": 176,
                "replyable": 1,
                "createTime": 1527242989000,
                "modifyTime": 1527242989000,
                "danmakuId": "0755f91651554e338741f7cb75c05c65"
            },
            {
                "epId": 218,
                "epIndex": 2,
                "bangumiId": 176,
                "replyable": 1,
                "createTime": 1527242989000,
                "modifyTime": 1527242989000,
                "danmakuId": "37778c4482d94355be8aa8d9709b603a"
            },
            {
                "epId": 219,
                "epIndex": 1,
                "bangumiId": 177,
                "replyable": 1,
                "createTime": 1527243127000,
                "modifyTime": 1527243127000,
                "danmakuId": "8eaf7fd9cce541678139650c5bcce6cc"
            },
            {
                "epId": 220,
                "epIndex": 2,
                "bangumiId": 177,
                "replyable": 1,
                "createTime": 1527243127000,
                "modifyTime": 1527243127000,
                "danmakuId": "710c3f5da3e4405cac41972a647c9182"
            },
            {
                "epId": 221,
                "epIndex": 3,
                "bangumiId": 177,
                "replyable": 1,
                "createTime": 1527243542000,
                "modifyTime": 1527243542000,
                "danmakuId": "fa940c876234411aa2eb45024cbe7801"
            },
            {
                "epId": 222,
                "epIndex": 3,
                "bangumiId": 176,
                "replyable": 1,
                "createTime": 1527244393000,
                "modifyTime": 1527244393000,
                "danmakuId": "1525ca30f07941bd8552d459a867d4fd"
            },
            {
                "epId": 223,
                "epIndex": 1,
                "bangumiId": 178,
                "replyable": 1,
                "createTime": 1527245259000,
                "modifyTime": 1527245259000,
                "danmakuId": "686de6e0d32f40b0890fc6e249da8458"
            },
            {
                "epId": 224,
                "epIndex": 2,
                "bangumiId": 178,
                "replyable": 1,
                "createTime": 1527245259000,
                "modifyTime": 1527245259000,
                "danmakuId": "b94e7842674047e8af405dcf94264d64"
            },
            {
                "epId": 225,
                "epIndex": 3,
                "bangumiId": 178,
                "replyable": 1,
                "createTime": 1527245259000,
                "modifyTime": 1527245259000,
                "danmakuId": "b0f5f17d5df94ba087858784aa1340ba"
            }
        ],
        "page": {
            "totalSize": 44,
            "pageSize": 20,
            "pageNumber": 1
        }
    }
}
  • 获取指定id剧集

GET /admin/episodes/{epId}

参数

Name Type Description
epId Integer 剧集id

请求示例 GET /admin/episodes/217

返回数据

{
    "code": 0,
    "msg": "OK",
    "data": {
        "danmakuId": "0755f91651554e338741f7cb75c05c65",
        "episodeId": 217,
        "bangumiName": "樱花庄的宠物女孩",
        "bangumiId": 176,
        "episodeIndex": 1,
        "replyable": 1
    }
}

失败返回数据

{
    "code": 5001,
    "msg": "数据未找到",
    "data": null
}
  • 获取指定番剧的所有剧集

GET /admin/episodes/bid/{bangumiId}

参数

Name Type Description
bangumiId Integer 番剧id(required)
pageNum Integer 页码
pageSize Integer 页大小

默认为第1页,页大小为20 请求示例 GET /admin/episodes/bid/178

返回数据

{
    "code": 0,
    "msg": "OK",
    "data": {
        "episodes": [
            {
                "epId": 223,
                "epIndex": 1,
                "bangumiId": 178,
                "replyable": 1,
                "createTime": 1527245259000,
                "modifyTime": 1527245259000,
                "danmakuId": "686de6e0d32f40b0890fc6e249da8458"
            },
            {
                "epId": 224,
                "epIndex": 2,
                "bangumiId": 178,
                "replyable": 1,
                "createTime": 1527245259000,
                "modifyTime": 1527245259000,
                "danmakuId": "b94e7842674047e8af405dcf94264d64"
            },
            {
                "epId": 225,
                "epIndex": 3,
                "bangumiId": 178,
                "replyable": 1,
                "createTime": 1527245259000,
                "modifyTime": 1527245259000,
                "danmakuId": "b0f5f17d5df94ba087858784aa1340ba"
            }
        ],
        "page": {
            "totalSize": 3,
            "pageSize": 20,
            "pageNumber": 1
        }
    }
}

失败返回数据

{
    "code": 5001,
    "msg": "数据未找到",
    "data": []
}
  • 新增剧集

POST /admin/episodes

参数

Name Type Description
bangumiId Integer 番剧id
epIndex Integer 集数索引
replyable Boolean 是否可回复

请求示例

POST /admin/episodes
{
    "bangumiId": 177,
    "epIndex": 4,
    "replyable": 1
}

返回数据

{
    "code": 0,
    "msg": "OK",
    "data": {
        "danmakuId": "d17fc551e68e4d769829f81f3e4ad6da",
        "episodeId": 226,
        "bangumiName": "长门有希酱的消失",
        "bangumiId": 177,
        "episodeIndex": 4,
        "replyable": 1
    }
}

失败返回数据

{
    "code": 5002,
    "msg": "bangumiId不能为空",
    "data": null
}

OR

{
    "code": 5002,
    "msg": "bangumiId不存在",
    "data": null
}

OR

{
    "code": 5002,
    "msg": "插入数据不需要提供epId和danmakuId",
    "data": null
}

OR

{
    "code": 5002,
    "msg": "epIndex不能为空",
    "data": null
}

OR

{
    "code": 5002,
    "msg": "epIndex不能为负数",
    "data": null
}

OR

{
    "code": 5002,
    "msg": "replyable的值只能为0和1",
    "data": null
}

OR

{
    "code": 5002,
    "msg": "epIndex已存在",
    "data": []
}

OR

{
    "code": 5002,
    "msg": "episode添加失败",
    "data": null
}
  • 修改剧集信息

PUT /admin/episodes/{epId}

参数

Name Type Description
bangumiId Integer 番剧id
epIndex Integer 集数索引
bangumiId String 弹幕uuid
replyable Boolean 是否可回复

请求示例

PUT /admin/episodes/73
{
    "epIndex": 4,
    "bangumiId": 67,
    "replyable": 0
}

返回数据

{
    "code": 0,
    "msg": "OK",
    "data": {
        "epId": 73,
        "epIndex": 4,
        "bangumiId": 67,
        "replyable": 0,
        "createTime": "2018-05-21T12:51:32.000+0000",
        "modifyTime": "2018-05-21T12:53:24.823+0000",
        "danmakuId": "92f98cac149e412699952d5ecd87e7ea"
    }
}

失败返回数据

{
    "code": 5001,
    "msg": "epId不存在",
    "data": null
}

OR

{
    "code": 5001,
    "msg": "bangumiId不存在",
    "data": null
}

OR

{
    "code": 5002,
    "msg": "epIndex不能为负数",
    "data": null
}

OR

{
    "code": 5002,
    "msg": "replyable的值只能为0和1",
    "data": null
}

OR

{
    "code": 5002,
    "msg": "danmakuId非法",
    "data": null
}
  • 删除指定id剧集

DELETE /admin/episodes/{epId]

参数

返回数据

{
    "code": 0,
    "msg": "OK",
    "data": {
        "epId": 73,
        "epIndex": 4,
        "bangumiId": 67,
        "replyable": 0,
        "createTime": "2018-05-21T12:51:32.000+0000",
        "modifyTime": "2018-05-21T12:53:25.000+0000",
        "danmakuId": "92f98cac149e412699952d5ecd87e7ea"
    }
}

失败返回数据

{
    "code": 5002,
    "msg": "删除episode失败",
    "data": null
}
  • 批量删除剧集

DELETE /admin/episodes

参数

Name Type Description
episodes JSON 多个剧集信息

请求示例

DELETE /admin/episodes
{
"episodes":[{"epId":259,"epIndex":1,"bangumiId":209},{"epId":260,"epIndex":1,"bangumiId":210}]
}

每个剧集信息只需提供一个"epId":259,其它信息可不发送,比如

{
"episodes":[{"epId":259},{"epId":260}]
}

返回结果

{
    "code": 0,
    "msg": "批量是删除成功",
    "data": [
        {
            "epId": 259,
            "epIndex": 1,
            "bangumiId": 209,
            "replyable": 1,
            "createTime": 1529296190000,
            "modifyTime": 1529296190000,
            "danmakuId": "e36712238ba54520b2548b252e54252e"
        },
        {
            "epId": 260,
            "epIndex": 1,
            "bangumiId": 210,
            "replyable": 1,
            "createTime": 1529326668000,
            "modifyTime": 1529326668000,
            "danmakuId": "fcb8404c30f24994a4231719ba191d63"
        }
    ]
}

失败返回结果

{
    "code": 5002,
    "msg": "删除失败,剧集id不存在",
    "data": []
}

Clone this wiki locally