Creating feed links
Added by IBM contributorIBM | Edited by Claudia R Elbourn on June 26, 2015
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 feed, send a POST request to the remote applications feed of the community to which you want to add the feed.
Tags: commapi

Before you begin


You cannot add feeds to a community until the Feeds widget has been added to the community using the Customize menu option in the product user interface. It is not until the widget is explicitly added that the service document resource for feeds is available from the remote applications feed.
  1. Determine the URI to which to POST the feed Atom document to create the community feed 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 feed.
  3. Send the Atom document using a POST request to the following URI:
Table 1. Atom API request details
Method
Resource
URI
Input representation
POST
Communities remote applications feed
Value of the href attribute in the <link> element that has the following rel attribute value: rel="http://www.ibm.com/xmlns/prod/sn/remote-application/publish" for the entry with the Feeds category in the remote applications Atom document of the community to which you want to add the feed.
feed


Returned HTTP headers

HTTP/1.1 201 Created
Indicates that the feed was successfully created. If an error occurs, this header contains one of the error codes.

Error codes
  • HTTP/1.1 400 Bad Request
  • HTTP/1.1 401 Unauthorized
     
Related reference
Retrieving a remote applications list ic45Create New Article
Input
Method URI Description
POST /communities/service/atom/community/feeds Value of the href attribute of the <link> element with the rel="http://www.ibm.com/xmlns/prod/sn/feeds" attribute value for each community.
Content Type: application/atom+xml
Sample Request:
<?xml version="1.0" encoding="UTF-8"?>

<entry
 xmlns="http://www.w3.org/2005/Atom" 

 xmlns:app="http://www.w3.org/2007/app" 

 xmlns:snx="http://www.ibm.com/xmlns/prod/sn">
<category term="feed" scheme="http://www.ibm.com/xmlns/prod/sn/type">
</category>

<title type="text">Feed link test</title>

<content type="html">
</content>

<link href="https://greenhousestage.lotus.com/forums/atom/topics?communityUuid=050c03c9-e062-4804-a6fc-0462c880fcaf"/> 
</entry>
Name Type Optional Description
communityUuid
string No The UUID of the community you wish to create a feed link in.
Output
Content Type: application/atom+xml
Name Type Optional Description
Location
string No Link to edit_url of the feed link. You can use the web address specified here to subsequently retrieve and update the feed link.
Code Description
201
Created. Indicates that the feed link was successfully created. If an error occurs, this header contains one of the error codes.
400
Bad Request.
401
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.