Comments API

10 endpoints.

Method	Path	Summary
`GET`	`/api/{resourceType}/{resourceId}/comments`	Get all comments for a resource
`POST`	`/api/{resourceType}/{resourceId}/comments`	Add a comment to a resource
`POST`	`/api/{resourceType}/{resourceId}/comments/{commentId}`	Reply to a comment (nested comment)
`DELETE`	`/api/comments/{commentId}`	Delete a comment
`PATCH`	`/api/comments/{commentId}`	Edit a comment
`DELETE`	`/api/comments/{commentId}/like`	Unlike a comment
`POST`	`/api/comments/{commentId}/like`	Like a comment
`GET`	`/api/tweets/{tweetId}/comments`	Get tweet comments (تعليقات المنشور)
`POST`	`/api/tweets/{tweetId}/comments`	Add comment to tweet (إضافة تعليق)
`POST`	`/api/tweets/{tweetId}/comments/{commentId}`	Reply to a comment (الرد على تعليق)

Get all comments for a resource

GET /api/{resourceType}/{resourceId}/comments

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`resourceType`	path	yes	string	—
`resourceId`	path	yes	string (uuid)	—
`page`	query	no	integer	—
`limit`	query	no	integer	—

Responses

Status	Description	Body
`200`	List of comments	—

Add a comment to a resource

POST /api/{resourceType}/{resourceId}/comments

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`resourceType`	path	yes	string	—
`resourceId`	path	yes	string (uuid)	—

Request body (required) — multipart/form-data

Field	Type	Required	Description
`content`	string	yes	—
`file`	string (binary)	no	—

Responses

Status	Description	Body
`201`	Comment added successfully	—

Reply to a comment (nested comment)

POST /api/{resourceType}/{resourceId}/comments/{commentId}

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`resourceType`	path	yes	string	—
`resourceId`	path	yes	string (uuid)	—
`commentId`	path	yes	string (uuid)	—

Request body (required) — multipart/form-data

Field	Type	Required	Description
`content`	string	yes	—
`file`	string (binary)	no	—

Responses

Status	Description	Body
`201`	Reply added successfully	—

Delete a comment

DELETE /api/comments/{commentId}

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`commentId`	path	yes	string (uuid)	—

Responses

Status	Description	Body
`200`	Comment deleted successfully	—
`403`	Not authorized to delete this comment	—

Edit a comment

PATCH /api/comments/{commentId}

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`commentId`	path	yes	string (uuid)	—

Request body (required) — application/json

Field	Type	Required	Description
`content`	string	yes	—

Responses

Status	Description	Body
`200`	Comment updated successfully	—
`403`	Not authorized to edit this comment	—

Unlike a comment

DELETE /api/comments/{commentId}/like

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`commentId`	path	yes	string (uuid)	—

Responses

Status	Description	Body
`200`	Comment unliked successfully	—

Like a comment

POST /api/comments/{commentId}/like

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`commentId`	path	yes	string (uuid)	—

Responses

Status	Description	Body
`200`	Comment liked successfully	—

Get tweet comments (تعليقات المنشور)

GET /api/tweets/{tweetId}/comments

Returns paginated comments for a tweet Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`tweetId`	path	yes	string (uuid)	—
`page`	query	no	integer	—
`limit`	query	no	integer	—

Responses

Status	Description	Body
`200`	Paginated list of comments	—

Add comment to tweet (إضافة تعليق)

POST /api/tweets/{tweetId}/comments

Add a new comment to a tweet Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`tweetId`	path	yes	string (uuid)	—

Request body (required) — application/json

Type: CreateCommentRequest

Responses

Status	Description	Body
`201`	Comment added successfully	—
`403`	User is restricted from commenting	—

Reply to a comment (الرد على تعليق)

POST /api/tweets/{tweetId}/comments/{commentId}

Add a reply to an existing comment Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`tweetId`	path	yes	string (uuid)	—
`commentId`	path	yes	string (uuid)	—

Request body (required) — application/json

Type: CreateCommentRequest

Responses

Status	Description	Body
`201`	Reply added successfully	—