Retrieving a comment

Home

Retrieving a comment

Retrieve an Atom document representation of a comment associated with a file.
This method returns the Atom document of the comment. To retrieve a feed, see Getting a feed of comments.
See Authenticating requests for information about how to authenticate the request.

Atom API request details

Method URI Output representation Description
GET /basic/api/userlibrary/{userid}/document/{document-id}/comment/{comment-id}/entry comment Atom document Returns a comment from someone else's file.
GET /basic/api/myuserlibrary/document/{document-id}/comment/{comment-id}/entry comment Atom document Returns a comment from one of your files.

{document-id} is the value of the <td:uuid> or <td:label> elements in the file's Atom entry document and {userid} is the value of the <snx:userid> of the person who owns the file. See Searching Profiles for more information about how to determine a person's user ID.
You can use one or more of these headers with the GET request.

Input headers

Parameter Description
If-Modified-Since Used to validate the local cache of the feed and entry documents retrieved previously. If the feed or entry has not been modified since the specified date, HTTP response code 304 (Not Modified) is returned.
If-None-Match Contains an ETag response header sent by the server in a previous request to the same URL. If the ETag is still valid for the specified resource, HTTP response code 304 (Not Modified) is returned.

You can use one or more of these input parameters with the GET request. Separate multiple parameters with an ampersand (&).

Input parameters

Parameter Description
identifier Indicates how the document is identified in the {document-id} variable segment of the Web address. By default, look up is performed with the expectation that the URL contains the value from the <td:uuid> element of a File Atom entry. Specify "label" if the URL instead contains the value from the <td:label> element of a File Atom entry.

Input

None.

Output

An Atom entry document containing the comment. Returned HTTP Headers

HTTP/1.1 200 OK

Indicates that the comment was successfully found and returned. If an error occurs, this header will contain one of the error codes below.

Content-Type: application/atom+xml

Indicates that the document returned contains data in Atom format.

Error codes

HTTP/1.1 401 Unauthorized
HTTP/1.1 404 Not Found

Working with comments

Related reference

Searching Profiles
Comment content

+
Search Tips | Advanced Search

Method	URI	Output representation	Description
GET	/basic/api/userlibrary/{userid}/document/{document-id}/comment/{comment-id}/entry	comment Atom document	Returns a comment from someone else's file.
GET	/basic/api/myuserlibrary/document/{document-id}/comment/{comment-id}/entry	comment Atom document	Returns a comment from one of your files.

Parameter	Description
If-Modified-Since	Used to validate the local cache of the feed and entry documents retrieved previously. If the feed or entry has not been modified since the specified date, HTTP response code 304 (Not Modified) is returned.
If-None-Match	Contains an ETag response header sent by the server in a previous request to the same URL. If the ETag is still valid for the specified resource, HTTP response code 304 (Not Modified) is returned.