Community articleGetting a feed that contains a person's default blog
Added by IBM contributorIBM on June 19, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Get a feed that contains the default blog of a specific user. You can retrieve all of the posts in the blog, or search for particular posts.



Get a feed that contains the default blog of a specific user. You can retrieve all of the posts in the blog, or search for particular posts.

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 entries.


Input
Method URI Description
GET /blogs/roller-ui/feed/{emailaddress} This feed returns a redirect to the user's default blog handle.
Note: A handle is specified when a blog is first created and is used in the construction of web addresses used to query the entries in a blog.
{emailaddress} represents the email address of the person whose blog you want to search. 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
If IBM® Connections is configured to prevent email addresses from being displayed, use the {userid} resource instead.
GET /blogs/roller-ui/feed/{userid}
This feed returns a redirect to the user's default blog handle.
Note: A handle is specified when a blog is first created and is used in the construction of web addresses used to query the entries in a blog.
{userid} represents the user ID of the person whose blog you want to search.
Name Type Optional Description
emailaddress
string No emailaddress} represents the email address of the person whose blog you want to search. 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
If IBM® Connections is configured to prevent email addresses from being displayed, use the {userid} resource instead.
userid
string No {userid} represents the user ID of the person whose blog you want to search.
Name Type Optional Description
page
int Yes Page number. Specifies the page to be returned. The first page is page 0.
ps
int Yes Page size. Specifies the number of entries to return per page.
search
string Yes Well-formed full text search query. Performs a text search of the blog entries.
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. Popularity is determined by the number of times an entry has been visited.
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
tags
string Yes Returns blog entries with the specified tags. Separate multiple tags with a plus sign (+).
Output
Content Type: application/atom+xml
Examples
> GET /blogs/roller-ui/feed/amy_jones%40us.example.com HTTP/1.1

> Host: blogs.enterprise.example.com:9082

> Accept: */*

Response returned by the server
<?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-f08f56e6-dc1a-4946-acf0-45511c9465a1</id> 

  <title type="text">Using Sametime</title> 

  <subtitle type="html" /> 

  <link 

   rel="self" 

   type="application/atom+xml" 

   href="https://blogs.enterprise.example.com:9444/blogs/usest/feed/entries/atom?

    lang=en_us" /> 

  <link 

   rel="edit" 

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

    blogs/f08f56e6-dc1a-4946-acf0-45511c9465a1?lang=en_us" 

   type="application/atom+xml" /> 

  <link 

   rel="alternate" 

   type="text/html" 

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

  <link 

   rel="replies" 

   type="application/atom+xml" 

   href="https://blogs.enterprise.example.com:9444/blogs/usest/feed/comments/atom?

    lang=en_us" /> 

  <link 

   rel="media" 

   type="application/atom+xml" 

   href="https://blogs.enterprise.example.com:9444/blogs/usest/feed/media/atom?

    lang=en_us" /> 

  <link 

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

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

    issuecategories/atom?lang=en_us" /> 

  <link 

   rel="first" 

   type="application/atom+xml" 

   href="https://blogs.enterprise.example.com:9444/blogs/usest/feed/entries/atom?

    lang=en_us" /> 

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

  <app:categories 

   href="https://blogs.enterprise.example.com:9444/blogs/usest/feed/tags/atom?

    lang=en_us" /> 

  <updated>2009-07-30T12:33:23-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/usest/entry/

    thoughts_on_using_sametime" xml:lang="en-US">

    <id>urn:lsid:ibm.com:blogs:entry-26619d6a-8449-4f82-aa1e-ec276af65dc5</id> 

    <title type="text">Thoughts on using Sametime</title> 

    <author>

      <name>Lou Green</name> 

      <email>lgreen@us.example.com</email> 

      <snx:userid>5b788f40-7d67-102c-845c-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/usest/entry/

      thoughts_on_using_sametime?lang=en_us" /> 

    <link 

     rel="self" 

     type="application/atom+xml" 

     href="https://blogs.enterprise.example.com:9444/blogs/usest/feed/entry/atom?

      entryid=26619d6a-8449-4f82-aa1e-ec276af65dc5&lang=en_us" /> 

    <link 

     rel="replies" 

     type="application/atom+xml" 

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

      thoughts_on_using_sametime/atom?lang=en_us" 

     thr:count="1" /> 

    <link 

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

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

      reports/26619d6a-8449-4f82-aa1e-ec276af65dc5?lang=en_us" /> 

    <link 

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

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

      entryrecommendations/26619d6a-8449-4f82-aa1e-ec276af65dc5/atom?lang=en_us" /> 

    <app:collection 

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

      entrycomments/26619d6a-8449-4f82-aa1e-ec276af65dc5?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/usest/api/recommend/

      entries/26619d6a-8449-4f82-aa1e-ec276af65dc5?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-30T12:31:36-04:00</published> 

    <updated>2009-07-30T12:31:36-04:00</updated> 

    <category term="st" /> 

    <link 

     rel="related" 

     type="text/html" 

     href="https://blogs.enterprise.example.com:9444/blogs/usest/tags/st?lang=

      en_us"/> 

    <content type="html">

      <! [CDATA [  Installed Notes 8.5 including Sametime and am now seeing the 

       business card in the product user interface.<br>I find it very useful for 

       accessing contact information for people that I exchange email with.<br>

       ]]&gt; 

    </content>

    <summary type="html">

      <! [CDATA [  Installed Notes 8.5 including Sametime and am now seeing the 

       business card in the product user interface. I find it very useful for 

       accessing contact information for people that I exchange email with.

       ]]&gt; 

    </summary>

    <snx:rank 

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

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

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

    <source>

      <id>urn:lsid:ibm.com:blogs:entries-f08f56e6-dc1a-4946-acf0-45511c9465a1</id> 

      <title type="text">Using Sametime</title> 

      <link 

       type="application/atom+xml" 

       rel="self" 

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

        atom?lang=en_us" /> 

      <link 

       type="text/html" 

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

      <updated>2009-07-30T12:33:23-04:00</updated> 

    </source>

  </entry>

</feed>