Available methods:
Required API scope: the one which gives read access to the post (public:read for public posts and private:read for private posts).
GET /api/v1/posts/:post_guid/comments
[
{
"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!",
"mentioned_people": [],
"interactions": {
"liked": false,
"likes_count": 0
},
"reported": false
},
{
"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@example.com}!",
"mentioned_people": [
{
"guid": "f50ffc00b188013355e3705681972339",
"diaspora_id": "alice@example.com",
"name": "Alice Testing",
"avatar": "http://example.com/uploads/images/thumb_medium_83abe5319ef830c2bd84.jpg"
},
],
"interactions": {
"liked": true,
"likes_count": 1
},
"reported": false
}
]
| Status code | Error reason |
|---|---|
| 404 | Post with provided guid could not be found |
Only the current users comments or comments written on the current users posts can be deleted.
Required API scope: interactions. Read access to the post must be present too (public:read for public posts and private:read for private posts).
DELETE /api/v1/posts/:post_guid/comments/:comment_guid
Status: 204 No Content
| Status code | Error reason |
|---|---|
| 403 | User not allowed to delete the comment |
| 404 | Post with provided guid could not be found |
| 410 | Comment not found for the given post |
Required API scope: interactions. Read access to the post must be present too (public:read for public posts and private:read for private posts).
POST /api/v1/posts/:post_guid/comments/:comment_guid/report
{
"reason": "Using my images without my permission."
}
Status: 204 No Content
| 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 |
Required API scope: interactions. Read access to the post must be present too (public:read for public posts and private:read for private posts).
POST /api/v1/posts/:post_guid/comments
{
"body": "Can I use these for my own website?"
}
{
"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?",
"mentioned_people": []
}
| 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 |