To create a community bookmark, send a POST request to the remote applications feed of the community to which you want to add the bookmark.
See Authenticating requests
for information about how to authenticate the request.
- Determine the URI to which to POST the bookmark Atom document to create the community bookmark by first accessing the service document for remote applications. See Retrieving a remote applications list for more details.
- Create an Atom document to represent the community bookmark.
- Send the Atom document using a POST request to the following URI:
Table 1. Atom API request details
Communities remote applications feed
From the entry in the Communities remote application feed that contains the <category term="Bookmarks" scheme="http://www.ibm.com/xmlns/prod/sn/type" /> element, find the value of the href attribute in the <link> element that has the rel="http://www.ibm.com/xmlns/prod/sn/remote-application/publish" attribute.
Provide a bookmark Atom entry document. The content type of the Atom entry document must be application/atom+xml.
An Atom entry document containing the new bookmark entry.
Returned HTTP headers
HTTP/1.1 201 Created
Indicates that the community bookmark was successfully created. If an error occurs, this header will contain one of the error codes below.Location: url
Link to edit_url of the new community bookmark. You can use the web address specified here to subsequently update the community bookmark.Error codes
Working with bookmarks programmatically
Retrieving a remote applications list
- HTTP/1.1 400 Bad Request
- HTTP/1.1 403 Forbidden: Authorization failed.