Get a feed that contains a person's default blog

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.

Table 1. Atom API request details

Resource

Description

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

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

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 (&).

Table 2. Input parameters

Parameter	Description
page	Page number. Specifies the page to be returned. The first page is page 0.
ps	Page size. Specifies the number of entries to return per page.
search	Well-formed full text search query. Performs a text search of the blog entries.
sortBy	Species what value to use as the basis for organizing the entries returned in the feed. The options are: commented Organize the entries by the number of comments or replies it has received. modified Organize the entries by modification date. recommended Organize the entries by number of recommendations. title Organize the entries by title. The title used is the text that is displayed in the <title> element of each entry in the feed. visited Organize the entries by the number of times an entry has been visited. Use with the sortOrder parameter to specify the order in which to display the results.
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 entries with the specified tags. Separate multiple tags with a plus sign (+).

Output

An Atom feed document containing the blog entries.

Example

To get a feed containing the default blog of the user with the email address amy_jones@us.example.com, send the following HTTP request:

> GET /blogs/roller-ui/feed/amy_jones%40us.example.com HTTP/1.1
> Host: blogs.enterprise.example.com:9082
> Accept: */*

The HTTP response would look as follows:

< HTTP/1.1 302 Found
< Location: http://blogs.enterprise.example.com:9082/blogs/amy11Blog/feed/entries/
  atom
...
* Issue another request to this URL: 'http://blogs.enterprise.example.com:9082/
  blogs/amy11Blog/feed/entries/atom'
* Re-using existing connection! (#0) with host blogs.enterprise.example.com
* Connected to blogs.enterprise.example.com (9.32.150.22) port 9082 (#0)
> GET /blogs/amy11Blog/feed/entries/atom HTTP/1.1
> Host: blogs.enterprise.example.com:9082
> Accept: */*
>
< HTTP/1.1 200 OK
...

The following content is 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>

Parent topic

Getting data from an individual blog

Related reference
Blog posting content

});