When you are viewing the latest updates listed on the Home page, you can mark an update as something you would like to read later by saving it as a saved story. A person's saved stories are listed in a collection. If you plan to update that collection using the resources made available through the Atom APIs, you must first retrieve the user's saved stories service document.

Important note: The News Repository APIs have been deprecated from the 4.0 release. These APIs are still functional for backward compatibility reasons - but no new feature is surfaced through these APIs. For any new development work, please refer to the OpenSocial Activity Stream APIs.

When you are viewing the latest updates listed on the Home page, you can mark an update as something you would like to read later by saving it as a saved story. A person's saved stories are listed in a collection. If you plan to update that collection using the resources made available through the Atom APIs, you must first retrieve the user's saved stories service document.

Table 1. Atom API request details

Method

Resource

URI

Description

GET

Service document

/news/atom/service

Accesses a user's service document to retrieve links to saved stories.

Example

To retrieve the service document for the stories saved by a specific user in the Home page application, send the following request:

GET /news/atom/service HTTP/1.1

Authorization: Basic xxx

Host: enterprise.example.com:9448

Accept: */*> GET /news/atom/service HTTP/1.1

The HTTP response would look as follows:

< HTTP/1.1 200 OK

< X-LConn-Auth: false

< Content-Type: application/atomsvc+xml

< Content-Language: en-US

< Set-Cookie: xxx; Path=/; Domain=.enterprise.example.com

< Set-Cookie: xxx; Path=/; Domain=.enterprise.example.com

< Transfer-Encoding: chunked

< Date: Wed, 24 Jun 2009 16:11:51 GMT

< Server: WebSphere Application Server/6.1

< Expires: xxx

< Cache-Control: no-cache="set-cookie, set-cookie2"

The service document for the Home page saved stories application is returned. For example: