Home

 

Get a feed of all recommended blog posts

Get a feed that includes all of the recommended blog posts in all of the blogs hosted by the Blogs feature.


Atom API request details

Resource Description
{homepage}/feed/recommended/atom A feed containing the recommended posts for all blogs.

{homepage} represents the blog handle of the blog configured to be the home page of the Blogs feature. The handle is defined when the home page blog is created by the administrator.

You can use one or more input parameters to limit the number of blog posts returned in the feed. Separate multiple parameters with an ampersand (&).


Input parameters

Parameter Description
email Narrows down the posts returned in the feed to only those recommended by a single person who you specify by internet e-mail address. Format the HTTP request using the proper URL encoding. For example, the encoded form of the @ symbol is %40 as in:

    adam_eventide%40garden.com
    

Do not provide this parameter if Lotus Connections is configured to prevent e-mail addresses from being displayed. It will return an error. Use the userid parameter instead.

page Page number. Specifies the page to be returned. The first page is page 0. The value must be an integer equal to or greater than 0.
ps Page size. Specifies the number of entries to return per page. The value must be an integer between 1 and 50.
sortBy Specifies what value to use as the basis for organizing the entries returned in the feed. The options are:

    modified

    Organize the entries by modification date.

    recommended

    Organize the entries by number of recommendations.

Use with the sortOrder parameter to specify which to show first: the most recent or oldest posts or the posts with the most or least recommendations.

sortOrder Specifies the order in which to list the feed entries. The options are:

    asc

    Displays the entries in ascending order.

    desc

    Displays the entries in descending order.

tags Returns blog posts with the specified tags. Separate multiple tags with a plus sign (+).
userid Narrows down the posts returned in the feed to only those recommended by a single person who you specify by unique ID. This value is specified in the <snx:userid> element.

 

Output

An Atom feed document containing the recommended blog posts. You can cache the returned feed.

 

Example

To get a feed of all of the comments made on the blog with the handle home, send the following HTTP request:

The HTTP response would look as follows:


Get data from all of the blogs


+

Search Tips   |   Advanced Search