Comments

Available methods:

Get comments for a post

Request

GET /api/v1/posts/:post_guid/comments

Response

[
  {
    "guid": "42817320b18c013355e5705681972339",
    "created_at": "2016-02-09T18:52:58.209Z",
    "author": {
      "guid": "f50ffc00b188013355e3705681972339",
      "diaspora_id": "alice@example.com",
      "name": "Alice Testing",
      "avatar": "http://example.com/uploads/images/thumb_medium_83abe5319ef830c2bd84.jpg"
    },
    "body": "What a wonderful post!"
  },
  {
    "guid": "9d164700b82f0133e40d406c8f31e210",
    "created_at": "2016-02-09T18:59:01.114Z",
    "author": {
      "guid": "cb7e4aa0b82f0133e40d406c8f31e210",
      "diaspora_id": "bob@example.com",
      "name": "Bob Testing",
      "avatar": "http://example.com/uploads/images/thumb_medium_a51bf501fe86c198c0b1.jpg"
    },
    "body": "Thank you very much, Alice!"
  }
]

Errors

Status code Error reason
404 Post with provided guid could not be found

Delete a comment

Only the current users comments or comments written on the current users posts can be deleted.

Request

DELETE /api/v1/posts/:post_guid/comments/:comment_guid

Response

Status: 204 No Content

Errors

Status code Error reason
403 User not allowed to delete the comment
404 Post with provided guid could not be found
404 Comment not found for the given post

Report a comment

Request

POST /api/v1/posts/:post_guid/comments/:comment_guid/report
{
  "reason": "Using my images without my permission."
}

Response

Status: 204 No Content

Errors

Status code Error reason
404 Post with provided guid could not be found
404 Comment not found for the given post
409 This item already has been reported by this user

Add a comment to a post

Request

POST /api/v1/posts/:post_guid/comments
{
  "body": "Can I use these for my own website?"
}

Response

{
  "guid": "010fb390b8310133e40d406c8f31e210",
  "created_at": "2016-02-18T05:46:52.649Z",
  "author": {
    "guid": "f50ffc00b188013355e3705681972339",
    "diaspora_id": "alice@example.com",
    "name": "Alice Testing",
    "avatar": "http://example.com/uploads/images/thumb_medium_83abe5319ef830c2bd84.jpg"
  },
  "body": "Can I use these for my own website?"
}

Errors

Status code Error reason
404 Post with provided guid could not be found
422 User is not allowed to comment
422 Couldn’t accept or process the comment