Get the top updates 

Get a feed that lists the top updates. The resulting feed includes updates about events in which the authenticated user is involved. The most recent updates are listed first in the resulting feed.

Table 1. Atom API request details

Resource Description
/atom/stories/top Gets a feed of the top updates.

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

Table 2. Parameters

Parameter Description
before Returns only those items that were last modified before the date specified by this parameter. Format the date using the syntax: 2008-02-07T21:07:56Z. See ftp://ftp.rfc-editor.org/in-notes/rfc4287.txt for details.
container Unique ID of one of the following items:

  • An activity in the Activities application

  • A blog in the Blogs application

  • A person's bookmark collection in the Bookmarks application

  • A community in the Communities application

  • A collection in the Files application

  • A forum in the Forums application

  • A person's profile in the Profiles application

  • A wiki in the Wikis application

The unique ID is defined in the <id> element for the Atom entry for the container. Each application defines Atom entry content and part of this content is the <id> element. Use this parameter with the source parameter. In the source parameter, specify the application in which this unique ID for the item is valid. This parameter is ignored if a valid application name is not specified in the source parameter.

email email address of a person. Use this parameter to limit the feed of updates to contain only updates generated by a specific person. Do not use this parameter if IBM Connections is configured to hide email addresses; use userid instead.
lang Use this parameter to request stories in a different language than specified in the HTTP request. To specify the language, use one of the following formats:

  • Java™ format (e.g. en_US, es_ES)

  • Dojo format (e.g. en-us, es-es)

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. The maximum number allowed is 100.
since Returns only those items that were last modified after the date specified by this parameter. Format the date using the syntax: 2008-02-07T21:07:56Z. See ftp://ftp.rfc-editor.org/in-notes/rfc4287.txt for details.
source Specify a single application from which you want the feed of updates to be returned. Options are:

userid Unique ID of a person. Use this parameter to limit the feed of updates to contain only updates generated by a specific person. The value of this parameter takes precedence when both this and the email parameter are specified.


You can use the ps and page parameters together.


Parent topic

Getting News repository feeds

Related reference
Saving stories


   

 

});