Get a list of popular bookmarks 

Retrieve a list of bookmarks ordered from the most popular to least popular.

This lists the bookmarks that multiple users have bookmarked recently. It captures the bookmarks that are displayed in the Most Bookmarked in the last 30 days section of the Popular tab of the Bookmarks application. To find all bookmarks sorted by popularity, retrieve the resource described in Search bookmarks using the sortOrder parameter. The administrator can change the number of days from 30 to something different.

Table 1. Atom API request details

Resource Description
/atom/popular Retrieves popular bookmarks. You can use this resource to subscribe to a set of bookmarks and get notifications of changes.

Use one or more of the input parameters to narrow the search. Separate multiple parameters with an ampersand (&).

Table 2. Input parameters

Parameter Description
lang Language code. Language of the strings in the output. If not specified, the first matching browser language is used, if available. The server then redirects the request to add this parameter to the URL. Specify this parameter to avoid a redirect.
page Page number. Specifies the page to be returned. The default is 1.
ps Page size. Specifies the number of entries to return per page.
type Filters the bookmarks returned in the feed. You can filter by the following values:
popular

    Returns a list of the most bookmarked web sites. This value is the default value.

visited

    Returns a list of the bookmarks that are accessed most often.


Example

To retrieve a list of popular bookmarks, send the following HTTP request:

> GET /dogear/atom/popular?lang=en HTTP/1.1
> Authorization: Basic ...
> Host: dogear.enterprise.example.com:9084
> Accept: */*

The HTTP response would look as follows:

< HTTP/1.1 200 OK
< Last-Modified: Thu, 07 Feb 2008 19:47:14 GMT
< Cache-Control: public,max-age=300,s-maxage=300
< Content-Type: application/atom+xml; charset=UTF-8
< Content-Language: en
< Transfer-Encoding: chunked
< Date: Thu, 07 Feb 2008 20:08:00 GMT
< Server: WAS/6.1

The following content is returned by the server:

<?xml version="1.0" encoding="utf-8" ?> 
<feed 
 xmlns="http://www.w3.org/2005/Atom" 
 xmlns:snx="http://www.ibm.com/xmlns/prod/sn" 
 xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">
  <generator 
   uri="http://www.ibm.com/xmlns/prod/sn" 
   version="1.0.2">IBM Connections - Dogear</generator> 
  <title>Bookmarks - Popular Bookmarks</title> 
  <link 
   rel="self" 
   type="application/atom+xml" 
   href="http://dogear.enterprise.example.com:9084/dogear/atom/popular?lang=en" 
  /> 
  <link 
   rel="http://www.ibm.com/xmlns/prod/sn/tag-cloud" 
   type="application/atomcat+xml" 
   href="http://dogear.enterprise.example.com:9084/dogear/tags/popular?lang=en" 
  /> 
  <link 
   rel="alternate" 
   type="text/html" 
   href="http://dogear.enterprise.example.com:9084/dogear/html/popular?lang=en" 
  /> 
  <opensearch:totalResults>1</opensearch:totalResults> 
  <id>tag:dogear.ibm.com,2005:feed://popular?lang=en</id> 
  <updated>2008-02-07T14:47:21-05:00</updated> 
  <entry>
    <id>tag:dogear.ibm.com,2005:link:7EDG7F0000011A9595DFCD976AA63900000C</id> 
    <title>M&M's.com</title> 
    <category scheme="http://www.ibm.com/xmlns/prod/sn/type" term="bookmark" /> 
    <link href="http://www.mms.com/" /> 
      <content type="html">
        <! [CDATA [ 
            <div><p>
               Link to the M&M web site.
            </p></div>
          ]]&gt; 
      </content>
      <published>2008-02-07T14:47:21-05:00</published> 
      <updated>2008-02-07T14:47:21-05:00</updated> 
      <category term="candy" /> 
      <author>
        <email>amy_jones5@us.example.com</email> 
        <name>Amy jones5</name> 
        <snx:userid>937965j0-4f0c-1028-5a06-db08267b51b2</snx:userid>
        <uri>http://dogear.enterprise.example.com:9084/dogear/html?email=
              amy_jones5%40us.example.com&lang=en</uri> 
      </author>
      <snx:clickcount>0</snx:clickcount> 
      <link 
       rel="http://www.ibm.com/xmlns/prod/sn/same" 
       type="application/atom+xml" 
       href="http://dogear.enterprise.example.com:9084/dogear/atom?
              for=http%3a%2f%2fwww.mms.com%2f&lang=en" /> 
    </entry>
  </feed>


Parent topic

Getting Bookmarks feeds


   

 

});