...
| Note | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
The following terms explain the meaning of the query parameters passed with the following REST URIs:
|
| Note |
|---|
The {start page} and {number of records} can take any value greater than or equal to 0. The {start page} and {number of records} begins with 1. If both of them are 0, then all the comments are retrieved. Please note that "start" and "size" are OPTIONAL parameters. If the user omits it will take the default value as 0. |
...
| Attributes | Values |
|---|---|
HTTP Method | GET |
| Request URI | /comments?path={ resource path }&start={ start page }&size={ number of records }&user={ user name } |
| HTTP Request Header | Authorization: Bearer { OAuth access token } |
| Description | This retrieves all the comments posted on the specific resource. |
| Response | HTTP 200 OK |
| Response Type | JSON |
Get a Specific Comment on a Resource
| Attributes | Values |
|---|---|
HTTP Method | GET |
| Request URI | /comment?path={ resource path }&id={ comment ID }&user={ user name id } |
| HTTP Request Header | Authorization: Bearer { OAuth access token } |
| Description | This retrieves the specific comment associated with the given comment ID.id. |
| Response | HTTP 200 OK |
| Response Type | JSON |
Add a Comment to a Resource
| Attributes | Values |
|---|---|
HTTP Method | POST |
| Request URI | /comment?path={ resource path }&user={ user name } |
| HTTP Request Header | Authorization: Bearer {OAuth access token} Content-Type: text/plain |
| Payload | Comment appears in text format |
| Description | Add the payload comment to the requested resource |
| Response | HTTP 204 No Content |
| Response Type | JSON |
Update a Comment on a Resource
| Attributes | Values |
|---|---|
HTTP Method | PUT |
| Request URI | /comment?path={ resource path }&id={ comment ID }&user={ user name id} |
| HTTP Request Header | Authorization: Bearer { OAuth access token } Content-Type: text/plain |
| Payload | New comment to be updated as TEXT. |
| Description | It replaces the new comment for the given commentIDcomment id |
| Response | HTTP 204 No Content |
| Response Type | JSON |
Delete a Comment on a Resource
| Attributes | Values |
|---|---|
HTTP Method | DELETE |
| Request URI | /comment?path={ resource path }&id={ comment ID }&user={ user name id} |
| HTTP Request Header | Authorization: Bearer { OAuth access token } |
| Response | HTTP 204 No Content |
| Response Type | JSON |
.