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
| /atom/stories/top||Gets a feed of the top updates.|
This resource continues to be supported for backwards compatibility. However, the /atom/stories/newsfeed resource, which was added in version 3, provides more robust information about the latest updates. This resource (atom/stories/top) is equivalent to atom/storienewsfeed?source=responses.
See Authenticating requests for information about how to authenticate the request.
Table 2. Parameters
|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:
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.
- 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
|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