Community articleGetting a feed of the latest posts added to all blogs
Added by IBM contributorIBM on March 13, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Get the Blogs home page feed to retrieve all of the blog posts across all of the blogs hosted by the Blogs application from most recent to oldest.


Get the Blogs home page feed to retrieve all of the blog posts across all of the blogs hosted by the Blogs application from most recent to oldest.

Usage notes

The home page blog is configured by the administrator during the installation of the Blogs application. See Specifying site-wide settings for Blogs in the Administering Blogs section of the product documentation and Configuring Blogs in the Installing section of the product documentation for more details.

Searches against this feed search all blog posts. You can narrow the search using the input parameters defined in Table 2. This feed uses a redirect to send the query to the appropriate blog handle.

Request parameters

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

Output

An Atom feed document containing the blog post entries.

Input
Method URI Description
GET /blogs/{homepage}/feed/entries/atom
Name Type Optional Description
homepage
string No {homepage} represents the blog handle of the blog configured to be the home page of the Blogs application. The handle is defined when the home page blog is created by the administrator, and is defined in the <snx:BlogsHomepageHandle> element in the service document for Blogs.
Name Type Optional Description
email
string Yes Internet email address of the person whose blog posts you want to return. Note: 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
Note: Do not use this parameter if IBM® Connections is configured to prevent email addresses from being displayed. Use the userid parameter instead.
f
enumerated Yes Field to search. Provide a value for this parameter when you perform a search to filter the search by field. The options are:
all
The default value is all.
Authorized values:
  • all
page
int Yes Page number. Specifies the page to be returned. The default value is 1, which returns the first page.
Note: Specifying 0 returns the first page also. This option is supported for backwards compatability only; it will be deprecated in a future release. Specifying 2 returns the second page.
ps
int Yes Page size. Specifies the number of entries to return per page. The default value is 10. The maximum value you can specify is 50.
search
string Yes Well-formed full text search query. Performs a text search of the blog posts.
since
string Yes Includes in the resulting feed all entries published after a specified date. Specify the date using a date-time value that conforms to http://www.ietf.org/rfc/rfc3339.txt" target="external">RFC3339. In addition, an uppercase "T" character must be used to separate date and time, and an uppercase "Z" character must be present in the absence of a numeric time zone offset. For example: 2009-01-04T20:32:31.171Z.
sortBy
enumerated Yes Species what value to use as the basis for organizing the entries returned in the feed. The options are:
commented
Sorts the entries by the number of comments or replies an item has received.
modified
Sorts the entries by the last modified date.
popularity
Sorts the entries by how popular the item is.
recommended
Sorts the entries by the number of times the item was recommended.
title
Sorts the entries alphabetically by title. The title used is the text that is displayed in the <title> element of each entry in the feed.
Use with the sortOrder parameter to specify the order in which to display the results.
Authorized values:
  • commented
  • modified
  • popularity
  • recommended
  • title
sortOrder
enumerated Yes Specifies the order in which to sort the results. The options are:
asc
Sorts the results in ascending order.
desc
Sorts the results in descending order.
Authorized values:
  • asc
  • desc
t
enumerated Yes Type of content to search. Provide a value for this parameter when you perform a search to filter the search by type. Options are:
blog
comment
entry
The default value is entry.
Authorized values:
  • blog
  • comment
  • entry
tags
string Yes Returns blog posts with the specified tags. Separate multiple tags with a plus sign (+).
userid
string Yes Unique ID that represents a specific person.
Output
Content Type: application/atom+xml
Code Description
200
OK. Indicates that the request was received successfully.
Examples
GET /blogs/home/feed/entries/atom HTTP/1.1

Host: blogs.enterprise.example.com:9081

Response returned by the server
HTTP/1.1 200 OK

Content-Type: application/atom+xml; charset=utf-8

 

<?xml version="1.0" encoding="utf-8" ?> 

<feed 

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

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

 xmlns:thr="http://purl.org/syndication/thread/1.0" 

 xmlns:snx="http://www.ibm.com/xmlns/prod/sn" 

 xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" 

 xml:lang="en-US">

  <id>urn:lsid:ibm.com:blogs:entries-0cbaac59-cf8c-46b9-8c30-060759c5cc58</id> 

  <title type="text">Acme Corp Blog Site</title> 

  <subtitle type="html">General Information Blog</subtitle> 

  <link 

   rel="self" 

   type="application/atom+xml" 

   href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/

    feed/entries/atom?lang=en_us" /> 

  <link 

   rel="alternate" 

   type="text/html" 

   href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog?

    lang=en_us" /> 

  <link 

   rel="replies" 

   type="application/atom+xml" 

   href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/

    feed/comments/atom?lang=en_us" /> 

  <link 

   rel="media" 

   type="application/atom+xml" 

   href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/

    feed/media/atom?lang=en_us" /> 

  <link 

   rel="http://www.ibm.com/xmlns/prod/sn/issues" 

   href="https://blogs.enterprise.example.com:9444/blogs/AcmeBlog/feed/

    issuecategories/atom?lang=en_us" /> 

  <link 

   rel="first" 

   type="application/atom+xml" 

   href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/

    feed/entries/atom?lang=en_us" /> 

  <openSearch:totalResults>1</openSearch:totalResults> 

  <app:categories 

   href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/

    feed/tags/atom?lang=en_us" /> 

  <updated>2009-07-30T10:02:10-04:00</updated> 

  <generator uri="http://www.ibm.com/xmlns/prod/sn" version="2.5">

   IBM Connections - Blogs

  </generator> 

  <entry 

   xml:base="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/entry/

    blog_placeholder" 

   xml:lang="en-US">

    <id>urn:lsid:ibm.com:blogs:entry-b770e0c8-527a-4cb0-9d3a-1774502c7fed</id> 

    <title type="text">Placeholder blog entry</title> 

    <author>

      <name>Mary Litman</name> 

      <email>mlitman@us.acme..com</email> 

      <snx:userid>5adff8c0-7d67-102c-8452-e2ebc3ec5536</snx:userid> 

      <snx:userState xmlns:snx="http://www.ibm.com/xmlns/prod/sn">active</snx:userState>

    </author>

    <link 

     rel="alternate" 

     type="text/html" 

     href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/entry/

      blog_placeholder?lang=en_us" /> 

    <link 

     rel="self" 

     type="application/atom+xml" 

     href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/feed/

      entry/atom?entryid=b770e0c8-527a-4cb0-9d3a-1774502c7fed&lang=en_us" /> 

    <link 

     rel="replies" 

     type="application/atom+xml" 

     href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/feed/

      entrycomments/blog_placeholder/atom?lang=en_us" thr:count="0" /> 

    <link 

     rel="http://www.ibm.com/xmlns/prod/sn/reports" 

     href="https://blogs.enterprise.example.com:9444/blogs/AcmeBlog/api/

      reports/b770e0c8-527a-4cb0-9d3a-1774502c7fed?lang=en_us" /> 

    <link 

     rel="http://www.ibm.com/xmlns/prod/sn/recommendations" 

     href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/feed/

      entryrecommendations/b770e0c8-527a-4cb0-9d3a-1774502c7fed/atom?lang=en_us" /> 

    <app:collection 

     href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/api/

      entrycomments/b770e0c8-527a-4cb0-9d3a-1774502c7fed?lang=en_us">

      <title type="text">Comment Entries</title> 

      <category 

       scheme="http://www.ibm.com/xmlns/prod/sn/collection" term="comments" /> 

      <app:categories fixed="yes" /> 

      <app:accept>application/atom+xml;type=entry</app:accept> 

    </app:collection>

    <app:collection 

     href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/api/

      recommend/entries/b770e0c8-527a-4cb0-9d3a-1774502c7fed?lang=en_us">

      <title type="text">Recommendations</title> 

      <category 

       scheme="http://www.ibm.com/xmlns/prod/sn/collection" 

       term="recommend" /> 

      <app:categories fixed="yes" /> 

    </app:collection>

    <published>2009-07-30T10:02:09-04:00</published> 

    <updated>2009-07-30T10:02:09-04:00</updated> 

    <category term="issues" /> 

    <category term="sales" /> 

    <category term="acme" /> 

    <link 

     rel="related" 

     type="text/html" 

     href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/tags/

      issues?lang=en_us" /> 

    <link 

     rel="related" 

     type="text/html" 

     href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/tags/

      sales?lang=en_us" /> 

    <link 

     rel="related" 

     type="text/html" 

     href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/tags/

      acme?lang=en_us" /> 

    <content type="html">

      <! [CDATA [ Entry: This entry has been created by the automated BVT.  It 

       is a simple, short posting to serve as a placeholder for others. 

       ]]&gt; 

    </content>

    <summary type="html">

      <! [CDATA [ Entry: This entry has been created by the automated BVT.  It 

       is a simple, short posting to serve as a placeholder for others. 

       ]]&gt; 

    </summary>

    <snx:rank 

     scheme="http://www.ibm.com/xmlns/prod/sn/recommendations">0</snx:rank> 

    <snx:rank 

     scheme="http://www.ibm.com/xmlns/prod/sn/comment">0</snx:rank> 

    <snx:rank 

     scheme="http://www.ibm.com/xmlns/prod/sn/hit">2</snx:rank> 

    <source>

      <id>urn:lsid:ibm.com:blogs:entries-0cbaac59-cf8c-46b9-8c30-060759c5cc58</id> 

      <title type="text">Acme Corp Blog Site</title> 

      <link 

       type="application/atom+xml" 

       rel="self" 

       href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog/feed/

        entries/atom?lang=en_us" /> 

      <link 

       type="text/html" 

       href="https://blogs.enterprise.example.com:9444/blogs/AcmeHomeBlog?lang=en_us" /> 

      <updated>2009-07-30T10:02:10-04:00</updated> 

    </source>

  </entry>

</feed>