Get a list of recommenders 

Retrieve a feed that lists the people who have recommended a blog posting.

See Authenticating requests for information about how to authenticate the request.

To get a list of recommenders...

1. Retrieve the blog entry that you want to recommend. See Retrieve blog posts.

2. In the returned entry document, find the <app:collection> element that has a child <title> element with a value of Recommendations, and then send a GET request to the web address defined in the href attribute of that element.
   

Table 1. Atom API request details

Method	Resource	URI	Output representation
GET	Recommendations feed	Value of the href attribute of the <app:collection> element that has a child <title> element with a value of Recommendations in the blog entry.	Recommenders feed

Input

None.

Output

Feed that lists the names of the people who have recommended the blog posting.

For example, the following feed indicates that one person, named Amy Murphy, has recommended the entry.

<?xml version="1.0" ?> 
  <feed xmlns="http://www.w3.org/2005/Atom">
  <updated>2009-07-06T16:42:59.000Z</updated> 
  <generator 
   version="2.5" 
   uri="http://www.ibm.com/xmlns/prod/sn">IBM Connections - Blogs
  </generator> 
  <id>urn:lsid:ibm.com:blogs:recommenders-e5605c46-6cc1-4d20-a3c7-22acfdde6c39</id> 
  <title type="text">Entry Recommended By</title> 
  <link 
   href="https://enterprise.example.com:9444/blogs/roller-ui/rendering/api/myhomeblog0706124009/
    api/recommend/entries/e5605c46-6cc1-4d20-a3c7-22acfdde6c39" 
   rel="self" 
   type="application/atom+xml" /> 
  <os:totalResults 
   xmlns:os="http://a9.com/-/spec/opensearch/1.1/">1</os:totalResults> 
  <entry>
    <id>urn:lsid:ibm.com:blogs:person-5adff8c0-7d67-102c-845a-e2ebc3ec5536</id> 
    <title type="text">Amy Murphy</title> 
    <summary type="text">Amy Murphy</summary> 
    <updated>2009-07-06T15:40:05.562Z</updated> 
    <category term="person" scheme="http://www.ibm.com/xmlns/prod/sn/type" /> 
    <contributor>
      <name>Amy Murphy</name> 
      <email>amurphy@example.com</email> 
      <snx:userid xmlns:snx="http://www.ibm.com/xmlns/prod/sn">
       5adff8c0-7d67-102c-845a-e2ebc3ec5536
      </snx:userid> 
    </contributor>
  </entry>
</feed>

Parent topic

Work with recommendations

Related reference
Recommending a blog posting
Retrieve blog posts

   

 

});

+

Search Tips   |   Advanced Search