Community articleRetrieving the saved stories service document4.0
Added by IBM contributorIBM on July 1, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

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.
 

Method URI Description
GET /news/atom/service Accesses a user's service document to retrieve links to saved stories.
Output
Code Description
200
OK. Indicates that the request was received successfully.
Examples
To retrieve the service document for the stories saved by a specific user in the Home page application:
GET /news/atom/service HTTP/1.1

	Authorization: Basic xxx

	Host: enterprise.example.com:9448

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


Response returned by the server
<service

	xmlns:atom="http://www.w3.org/2005/Atom"

	xmlns="http://www.w3.org/2007/app">

	<atom:generator

	xmlns:atom="http://www.w3.org/2005/Atom"

	version="2.5"

	uri="http://www.ibm.com/xmlns/prod/sn">

	IBM Connections - News Story service

	</atom:generator>

	<workspace>

	<atom:title

	xmlns:atom="http://www.w3.org/2005/Atom"

	type="text">

	IBM Connections - Stories saved by Lyla Miller

	</atom:title>

	<atom:category

	xmlns:atom="http://www.w3.org/2005/Atom"

	term="views"

	scheme="http://www.ibm.com/xmlns/prod/sn/workspace" />

	<collection

	href="https://enterprise.example.com/news/atom/stories/saved?

	userid=937835c0-8f0a-1028-8a08-db07163b51b2">

	<atom:title xmlns:atom="http://www.w3.org/2005/Atom" type="text">

	IBM Connections - Stories saved by Lyla Miller

	</atom:title>

	<atom:category

	xmlns:atom="http://www.w3.org/2005/Atom"

	term="saved-news"

	scheme="http://www.ibm.com/xmlns/prod/sn/collection" />

	<accept>entry</accept>

	<categories

	xmlns:atom="http://www.w3.org/2005/Atom"

	fixed="yes"

	scheme="https://enterprise.example.com/news/atom/service/flags" />

	</collection>

	</workspace>

	</service>