Community articleCreating community bookmarks
Added by IBM contributorIBM on March 28, 2013
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

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.
Tags: commapi



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.
  1. 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.
  2. Create an Atom document to represent the community bookmark.
  3. Send the Atom document using a POST request to the following URI:
  4. Table 1. Atom API request details
    Method
    Resource
    URI
    Input representation
    POST
    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.
    bookmark

Input

Provide a bookmark Atom entry document. The content type of the Atom entry document must be application/atom+xml.

Output

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
  • HTTP/1.1 400 Bad Request
  • HTTP/1.1 403 Forbidden: Authorization failed.

Related concepts
Working with bookmarks programmatically

Related reference
Retrieving a remote applications list