To retrieve a profile entry document, use the web address found in the entry's edit link in the profile service document. You can only retrieve the profile entry for the user whose credentials you use to authenticate the request. In other words, you can only retrieve your own profile entry document or someone else's if that person provides you with his authentication credentials.
You can use this operation to obtain profile entry information that you want to preserve prior to performing an update. See Updating profile entries
for more information. This method returns the Atom entry of a single profile as opposed to a feed of a profile or set of profiles.
If you want to edit the value of fields in a person's profile, get the rel="edit"
link for a specific person's profile. To do so, retrieve a feed of the profile and specify the output=vcard
parameter on the request. See Searching a user's profile
for more details.
See Authenticating requests
for information about how to authenticate the request.
Table 1. Atom API request details
Value of the href attribute of the <link> element with the rel="edit" attribute in the user's profile feed.
An Atom entry document containing the profile entry.
Returned HTTP headers
HTTP/1.1 200 OK
Indicates that the profile entry 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.Errors
Parent topic: Working with profiles
Updating profile entries
Searching for a user's profile
- HTTP/1.1 403 Unauthorized
- HTTP/1.1 404 Not Found