Skip to content

reply

Jump to bottom
echisan edited this page Jun 28, 2018 · 8 revisions

评论

这里解释一下以下可能会出现误解的地方。

评论 指的是评论，父级评论 回复 指的是在别人的评论里回复层主，或者回复某一层里面的某个人

发送评论

请求地址

POST /replies

请求参数

参数 类型 说明
uid String 需要把发布评论的用户的id传过来
ep_id Integer 该集数的id
content String 评论正文
r_page Integer 评论所在的页数，如果是评论可以不填，回复的话最好可以填上，当然不填也可以
is_parent Integer 否是父级评论，如果是则 1 ,不是则 0
p_uid String 如果是父级评论则不填，如果是回复，将被回复的对象的用户id传进来
p_rid String 如果是父级评论则不填，如果是回复，将该父级评论的id传进来

请求示例 评论

{
	"uid":"4028e381638d71d1016392b283ac0000", 
	"ep_id":14,   
	"content":"评论正文 ",    
	"r_page":1, 
	"is_parent":1,    
	"p_uid":"",  
	"p_rid":""
}

回复

{
	"uid":"4028e3816386ea9b016386f56cf50004",
	"ep_id":14,
	"content":"回复 ",
	"r_page":1,
	"is_parent":0,
	"p_uid":"4028e381638d71d1016392b283ac0000",
	"p_rid":"4028e38163a0726a0163a07741860000"
}

响应格式

{
    "code": 0,
    "msg": "OK",
    "data": {
        "replyId": "4028e38163a090b80163a0b5cfb20000",
        "content": "回复 ",
        "rPage": 1,
        "createTime": 1527409659773,
        "modifyTime": 1527409659773,
        "userId": "4028e3816386ea9b016386f56cf50004",
        "rStatus": "NORMAL",
        "parentId": "4028e38163a0726a0163a07741860000",
        "isParent": 0,
        "rLike": 0,
        "rHate": 0,
        "epId": 14
    }
}

获取某一集的评论

请求地址

GET /replies?epId={epId}&pn={pn}

请求参数

参数 类型 说明
epid Integer 该集数的id
pn Integer 页数，不填时默认为1

请求示例

/replies?epId=14

{
    "code": 0,
    "msg": "OK",
    "data": {
        "replies": [
            {
                "reply": {
                    "user": {
                        "uid": "4028e381638d71d1016392b283ac0000",
                        "nick": "admin",
                        "face": "/static/img/zm.jpg",
                        "sex": "不明"
                    },
                    "reply": {
                        "replyId": "4028ef8163d0660e0163d07ef9b40001",
                        "content": "(ﾟДﾟ≡ﾟдﾟ)!?",
                        "rPage": 1,
                        "createTime": 1528211372000,
                        "modifyTime": 1528211372000,
                        "userId": "4028e381638d71d1016392b283ac0000",
                        "rStatus": "",
                        "parentId": "",
                        "isParent": 1,
                        "rLike": 0,
                        "rHate": 0,
                        "epId": 6
                    },
                    "totalSize": 0,
                    "likeStatus": 0
                },
                "replies": []
            },
            {
                "reply": {
                    "user": {
                        "uid": "4028e381638d71d1016392b283ac0000",
                        "nick": "admin",
                        "face": "/static/img/zm.jpg",
                        "sex": "不明"
                    },
                    "reply": {
                        "replyId": "4028ef8163d0660e0163d07eea550000",
                        "content": "(^・ω・^ )",
                        "rPage": 1,
                        "createTime": 1528211369000,
                        "modifyTime": 1528211369000,
                        "userId": "4028e381638d71d1016392b283ac0000",
                        "rStatus": "",
                        "parentId": "",
                        "isParent": 1,
                        "rLike": 0,
                        "rHate": 0,
                        "epId": 6
                    },
                    "totalSize": 0,
                    "likeStatus": 0
                },
                "replies": []
            }
        ],
        "page": {
            "totalSize": 2,
            "parentTotalSize": 2,
            "pageNumber": 1,
            "pageSize": 20
        }
    }
}

分页信息

参数 说明
totalSize 该评论下的回复总数
pageSize 每页父级评论的大小
pageNumber 当前分页
parentTotalSize 该评论下的父级评论总数，分页根据这个，总页数 = parentTotalSize / pageSize

获取某一父评论下某一页的子评论

请求地址

GET /replies/son?prid={prid}&pn={pn}

参数 说明
prid 父级评论的id
pn 第几页(默认每页只显示10条，当然我也不提供修改的接口)

请求示例 url http://localhost:8080/replies/son/?prid=4028ef8163caf5fa0163cb50921d0012&pn=1

返回结果

{
    "code": 0,
    "msg": "OK",
    "data": {
        "replies": [
            {
                "user": {
                    "uid": "4028e381638d71d1016392b283ac0000",
                    "nick": "admin",
                    "face": "",
                    "sex": "不明"
                },
                "reply": {
                    "replyId": "4028ef8163caf5fa0163cb73f7ed0013",
                    "content": "test",
                    "rPage": 1,
                    "createTime": 1528126765000,
                    "modifyTime": 1528126765000,
                    "userId": "4028e381638d71d1016392b283ac0000",
                    "rStatus": "",
                    "parentId": "4028ef8163caf5fa0163cb50921d0012",
                    "isParent": 0,
                    "rLike": 0,
                    "rHate": 0,
                    "epId": 15
                },
                "totalSize": 0,
                "likeStatus": 1
            },
            {
                "user": {
                    "uid": "4028e381638d71d1016392b283ac0000",
                    "nick": "admin",
                    "face": "",
                    "sex": "不明"
                },
                "reply": {
                    "replyId": "4028ef8163caf5fa0163cb741f8c0015",
                    "content": "回复 @admin :(=・ω・=)",
                    "rPage": 1,
                    "createTime": 1528126775000,
                    "modifyTime": 1528126775000,
                    "userId": "4028e381638d71d1016392b283ac0000",
                    "rStatus": "",
                    "parentId": "4028ef8163caf5fa0163cb50921d0012",
                    "isParent": 0,
                    "rLike": 0,
                    "rHate": 0,
                    "epId": 15
                },
                "totalSize": 0,
                "likeStatus": 1
            },
            {
                "user": {
                    "uid": "4028e381638d71d1016392b283ac0000",
                    "nick": "admin",
                    "face": "",
                    "sex": "不明"
                },
                "reply": {
                    "replyId": "4028ef8163caf5fa0163cb749f380019",
                    "content": "回复 @admin :(=・ω・=)",
                    "rPage": 1,
                    "createTime": 1528126808000,
                    "modifyTime": 1528126808000,
                    "userId": "4028e381638d71d1016392b283ac0000",
                    "rStatus": "",
                    "parentId": "4028ef8163caf5fa0163cb50921d0012",
                    "isParent": 0,
                    "rLike": 0,
                    "rHate": 0,
                    "epId": 15
                },
                "totalSize": 0,
                "likeStatus": 1
            },
            {
                "user": {
                    "uid": "4028e381638d71d1016392b283ac0000",
                    "nick": "admin",
                    "face": "",
                    "sex": "不明"
                },
                "reply": {
                    "replyId": "4028ef8163caf5fa0163cb7445bd0017",
                    "content": "求求你睡觉吧",
                    "rPage": 1,
                    "createTime": 1528131029000,
                    "modifyTime": 1528126785000,
                    "userId": "4028e381638d71d1016392b283ac0000",
                    "rStatus": "",
                    "parentId": "4028ef8163caf5fa0163cb50921d0012",
                    "isParent": 0,
                    "rLike": 0,
                    "rHate": 0,
                    "epId": 15
                },
                "totalSize": 0,
                "likeStatus": 1
            }
        ],
        "page": {
            "totalSize": 4,
            "parentTotalSize": 0,
            "pageNumber": 1,
            "pageSize": 10
        }
    }
}

删除评论

请求地址 DELETE /replies/{reply_id}

点赞（不写踩了）

请求地址 POST /replies/like/{reply_id}/{action}

参数 类型 说明
reply_id String 该评论的id
action Integer 点赞的行为，有两个取值(0跟1)，0: 取消点赞，1：点赞 
{
    "code": 0,
    "msg": "OK",
    "data": {
        "r_like": 1,
        "reply_id": "4028ef8163cf0eb40163cfcdee510018"
    }
}

根据评论id获取评论

GET /replies?rid={reply_id}

请求示例 /replies?rid=4028ef816446fc6c01644700d765000b

响应结果一致

Clone this wiki locally