Comment_API.md

Comment API Document

Lấy ra danh sách các comment của một bài viết (bằng id hoặc slug)

---

Trả về 1 danh sách các comment của một bài viết (được sắp xếp tăng dần theo ngày comment)

• URL: /comment/post/{post_id} hoặc /comment/post?slug={slug}

• Method: GET

• Header: Authorization: Bearer <access token> (optional)

• Request Params:

  Name	Type	Description	Default
  page	int	Index của page	0
  size	int	Số lượng comment trả về	10

• Success Response:

  • Code: 200 OK - Kèm 1 danh sách các Comment thuộc bài viết đó
  • Example: GET /comment/post/3

[
  {
    "commentId": 7,
    "commenter": {
      "accountId": 4,
      "name": "Trinhdvt2",
      "email": "trinhdvt2@gmail.com",
      "postCount": 0,
      "followCount": 0,
      "bookmarkOnOwnPostCount": 0,
      "commentOnOwnPostCount": 0,
      "fbLink": null,
      "instagramLink": null,
      "avatarLink": "https://lh3.googleusercontent.com/a/AATXAJwep-n67Wo_25OpuJb5x2jIzRMz8tj7uCEfGMR2=s96-c",
      "about": null,
      "occupation": null
    },
    "commentDate": "2021-05-06 15:27",
    "content": "Bình tĩnh mấy bro",
    "likeCount": 1,
    "liked": false,
    "myComment": true
  },
  {
    "commentId": 11,
    "commenter": {
      "accountId": 4,
      "name": "Trinhdvt2",
      "email": "trinhdvt2@gmail.com",
      "postCount": 0,
      "followCount": 0,
      "bookmarkOnOwnPostCount": 0,
      "commentOnOwnPostCount": 0,
      "fbLink": null,
      "instagramLink": null,
      "avatarLink": "https://lh3.googleusercontent.com/a/AATXAJwep-n67Wo_25OpuJb5x2jIzRMz8tj7uCEfGMR2=s96-c",
      "about": null,
      "occupation": null
    },
    "commentDate": "2021-05-11 15:23",
    "content": "<p>This is new content for my comment</p>",
    "likeCount": 0,
    "liked": false,
    "myComment": true
  }
]

• Error Response:

  • Code: 404 NOT_FOUND - Không tìm bài viết

Thêm một comment

---

Thêm 1 comment vào bài viết

• URL: /comment/post/{post_id}

• Method: POST

• Header: Authorization: Bearer <token hiện tại>

• Request Body Content-Type: multipart/form-data

  Name	Type	Description
  content	string	Nội dung của comment (không được rỗng)

• Success Response:

  • Code: 200 OK - Kèm thông tin của Comment vừa được thêm

  • Example:

{
  "commentId": 14,
  "commenter": {
    "accountId": 4,
    "name": "Trinhdvt2",
    "email": "trinhdvt2@gmail.com",
    "postCount": 0,
    "followCount": 0,
    "bookmarkOnOwnPostCount": 0,
    "commentOnOwnPostCount": 0,
    "fbLink": null,
    "instagramLink": null,
    "avatarLink": "https://lh3.googleusercontent.com/a/AATXAJwep-n67Wo_25OpuJb5x2jIzRMz8tj7uCEfGMR2=s96-c",
    "about": null,
    "occupation": null
  },
  "commentDate": "2021-05-12 13:40",
  "content": "<p>Hello my friend</p>",
  "likeCount": 0,
  "liked": false,
  "myComment": true
}

• Error Response:

  • Code: 404 NOT_FOUND - bài viết không tồn tại

  • Code: 403 FORBIDDEN - chưa đăng nhập

Sửa một comment

---

Sửa nội dung của một comment

• URL: /comment/{comment_id}

• Method: PUT

• Header: Authorization: Bearer <token hiện tại>

• Request Body Content-Type: multipart/form-data

  Name	Type	Description
  content	string	Nội dung mới (không được rỗng)

• Response: Giống y như phần trên

Xoá một comment

---

Xoá một comment

• URL: /comment/{comment_id}

• Method: DELETE

• Header: Authorization: Bearer <token hiện tại>

• Success Response:

  • Code: 200 OK - Xoá thành công kèm theo số lượng comment của bài viết hiện tại

• Error Response:

  • Code: 404 NOT_FOUND - Comment không tồn tại

  • Code: 403 FORBIDDEN / 401 UNAUTHORIZED - chưa đăng nhập / không sở hữu

Like / Unlike comment

---

Like / Unlike comment, nếu đã like thì sẽ trở thành unlike và ngược lại

• URL: /comment/{comment_id}/like

• Method: PUT

• Header: Authorization: Bearer <token hiện tại>

• Success Response:

  • Code: 200 OK - Kèm theo số lượng like của comment vừa rồi

• Error Response:

  • Code: 404 NOT_FOUND - Comment không tồn tại

  • Code: 403 FORBIDDEN - Chưa đăng nhập