Get a feed of the comments added to a blog

Get a feed that lists the comments added to the posts in a single blog.

Table 1. Atom API request details

Resource	Description
{handle}/feed/comments/atom	A feed containing the comments for a particular blog. Note: {handle} represents the handle of the blog. A handle is a keyword that 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.

You can use one or more input parameters to limit the number of comments 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. 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.

Output

An Atom feed document containing the blog comments.

Example

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

> GET /blogs/writer/feed/comments/atom HTTP/1.1
> Authorization: Basic ...
> Host: blogs.enterprise.example.com
> Accept: */*

The HTTP response would look as follows:

< HTTP/1.1 200 OK
< Date: Tue, 26 Feb 2008 22:13:41 GMT
< Server: IBM_HTTP_Server
< Last-Modified: Thu, 07 Feb 2008 15:27:41 GMT
< Set-Cookie: JSESSIONID=0000qS9OBdXn_r21B5T2gBvrODW:-1; Path=/
< Expires: Thu, 01 Dec 1994 16:00:00 GMT
< Cache-Control: no-cache="set-cookie, set-cookie2"
< Transfer-Encoding: chunked
< Content-Type: application/atom+xml
< Content-Language: en-US

The following content is returned by the server:

<?xml version="1.0" encoding="utf-8" ?> 
<feed 
 xmlns="http://www.w3.org/2005/Atom" 
 xmlns:thr="http://purl.org/syndication/thread/1.0" 
 xmlns:app="http://www.w3.org/2007/app" 
 xmlns:snx="http://www.ibm.com/xmlns/prod/sn" 
 xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/">
  <id>urn:lsid:ibm.com:blogs:comments-f08f56e6-dc1a-4946-acf0-45511c9465a1</id> 
  <title type="html">Using Sametime (Comments)</title> 
  <subtitle type="html">(Comments)</subtitle> 
  <link 
   rel="alternate" 
   type="text/html" 
   href="https://blogs.enterprise.example.com:9444/blogs/usest?lang=en_us" /> 
  <link 
   rel="self" 
   type="application/atom+xml" 
   href="https://blogs.enterprise.example.com:9444/blogs/usest/feed/comments/
    atom?lang=en_us" /> 
  <link 
   rel="first" 
   type="application/atom+xml" 
   href="https://blogs.enterprise.example.com:9444/blogs/usest/feed/comments/
    atom?lang=en_us" /> 
  <openSearch:totalResults>1</openSearch:totalResults> 
  <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">
    <id>urn:lsid:ibm.com:blogs:comment-c361cdef-7bd6-42fe-a6a0-8255f640b25d</id> 
    <title type="text">Re: Thoughts on using Sametime</title> 
    <author>
      <name>Sandra Leer</name> 
      <email>skleer@us.example.com</email> 
      <snx:userid>5adff8c0-7d67-102c-845a-e2ebc3ec5536</snx:userid> 
      <snx:userState xmlns:snx="http://www.ibm.com/xmlns/prod/sn">active</snx:userState>
    </author>
    <link 
     rel="self" 
     type="application/atom+xml" 
     href="https://blogs.enterprise.example.com:9444/blogs/usest/feed/comment/
      atom?commentid=c361cdef-7bd6-42fe-a6a0-8255f640b25d&lang=en_us" /> 
    <link 
     rel="alternate" 
     type="text/html" 
     href="https://blogs.enterprise.example.com:9444/blogs/usest/entry/
      thoughts_on_using_sametime?lang=en_us#comment-1248971600562" /> 
    <link 
     rel="http://www.ibm.com/xmlns/prod/sn/recommendations" 
     href="https://blogs.enterprise.example.com:9444/blogs/usest/feed/
      commentrecommendations/c361cdef-7bd6-42fe-a6a0-8255f640b25d/atom?
      lang=en_us" /> 
    <app:collection 
     href="https://blogs.enterprise.example.com:9444/blogs/usest/api/recommend/
      comments/c361cdef-7bd6-42fe-a6a0-8255f640b25d?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:33:20-04:00</published> 
    <updated>2009-07-30T12:33:20-04:00</updated> 
    <content type="html">
      <! [CDATA [ I agree. I prevented it from popping up when I hover. I like 
       opening it myself.
       ]]&gt; 
    </content>
    <summary type="html">
      <! [CDATA [ I agree. I prevented it from popping up when I hover. I like 
       opening it myself.
       ]]&gt; 
    </summary>
    <category term="st" /> 
    <link 
     rel="related" 
     type="text/html" 
     href="https://blogs.enterprise.example.com:9444/blogs/usest/tags/st?lang=
      en_us" /> 
    <thr:in-reply-to 
     ref="urn:lsid:ibm.com:blogs:entry-26619d6a-8449-4f82-aa1e-ec276af65dc5" 
     source="https://blogs.enterprise.example.com:9444/blogs/usest/feed/entries/
      atom?lang=en_us" 
     href="https://blogs.enterprise.example.com:9444/blogs/usest/entry/
      thoughts_on_using_sametime?lang=en_us" type="text/html" /> 
    <snx:rank 
     scheme="http://www.ibm.com/xmlns/prod/sn/recommendations">0</snx:rank> 
    <source>
      <id>urn:lsid:ibm.com:blogs:entrycomments-26619d6a-8449-4f82-aa1e-
       ec276af65dc5</id> 
      <title type="text">Using Sametime - Comments</title> 
      <link 
       type="application/atom+xml" 
       rel="self" 
       href="https://blogs.enterprise.example.com:9444/blogs/usest/feed/
        entrycomments/thoughts_on_using_sametime/atom?lang=en_us" /> 
      <link 
       type="text/html" 
       href="https://blogs.enterprise.example.com:9444/blogs/usest/entry/
        thoughts_on_using_sametime?lang=en_us" /> 
    </source>
  </entry>
</feed>

Parent topic

Getting data from an individual blog

});