Community articleRetrieving forums
Added by IBM contributorIBM on June 27, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

To retrieve complete information about a forum, use the edit <link> found in the forum entry in the Forums feed.



To retrieve complete information about a forum, use the edit <link> found in the forum entry in the Forums feed.

You can use this operation to obtain forum information that you want to preserve prior to performing an update. See Updating forums for more information. This method returns the Atom entry of a single forum as opposed to a feed of all the forums.

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

 
Input
Method URI Description
GET /forums/atom/forum Web address returned in the HTTP location header when the forum was created.
Web address in the href attribute of the <link> element with the rel="edit" attribute of a forum Atom entry in the Forums feed.
Name Type Optional Description
forumUuid
string No The UUID of the forum you wish to retrieve.
Output
Content Type: application/atom+xml
Code Description
200
Indicates that the forum was successfully found and returned. If an error occurs, this header will contain one of the error codes below.
401
Unauthorized.
404
Not Found.
Examples
GET /forums/atom/forum?forumUuid=3b153694-e27e-4085-8868-2952110fdad2 HTTP/1.1

	Host: www.dulcinea.com

	Content-Type: application/atom+xml

	Authorization: xxx


Response returned by the server
HTTP/1.0 200 OK

	Date: Mon, 11 Jun 2008 18:31:02 GMT

	Content-Type: application/atom+xml

	

	<?xml version="1.0" encoding="UTF-8"?>

	<entry

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

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

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

	xmlns:thr="http://purl.org/syndication/thread/1.0">

	<id>urn:lsid:ibm.com:forum:3b153694-e27e-4085-8868-2952110fdad2</id>

	<title type="text">CKEditor</title>

	<published>2010-08-04T15:13:29.746Z</published>

	<updated>2010-08-04T18:06:59.481Z</updated>

	<author>

	<email>jdoe@literature.com</email>

	<name>Jane Doe</name>

	<snx:userid>F1449510-CF43-D282-8525-7346003DAD9D</snx:userid>

	<snx:userState>active</snx:userState>

	</author>

	<contributor>

	<email>tsmith@literature.com</email>

	<name>Tom Smith</name>

	<snx:userid>4C259C9C-9F1C-85B0-8525-7346003DB02A</snx:userid>

	<snx:userState>active</snx:userState>

	</contributor>

	<link

	href="http://www.dulcinea.com/forums/atom/entries?forumUuid=3b153694-e27e-4085-8868-2952110fdad2"

	rel="self"

	type="application/atom+xml">

	</link>

	<link

	href="http://www.dulcinea.com/forums/atom/forum?forumUuid=3b153694-e27e-4085-8868-2952110fdad2"

	rel="edit"

	type="application/atom+xml">

	</link>

	<category term="forum-forum" scheme="http://www.ibm.com/xmlns/prod/sn/type"></category>

	<category term="ckeditor"></category>

	<link

	href="http://www.dulcinea.com/forums/html/forum?id=3b153694-e27e-4085-8868-2952110fdad2"

	rel="alternate"

	type="text/html">

	</link>

	<link

	href="http://www.dulcinea.com/forums/atom/topics?forumUuid=3b153694-e27e-4085-8868-2952110fdad2"

	rel="replies"

	type="application/atom+xml"

	thr:count="0">

	</link>

	<link

	href="http://www.dulcinea.com/forums/atom/service?forumUuid=3b153694-e27e-4085-8868-2952110fdad2"

	rel="service"

	type="application/atomsvc+xml"

	title="Atom Publishing Protocol">

	</link>

	<thr:in-reply-to

	href="http://www.dulcinea.com/forums/atom/forums"

	ref="http://www.dulcinea.com/forums/atom/forums"

	type="application/atom+xml">

	</thr:in-reply-to>

	<content type="html">Read a great short story yesterday.</content>

	</entry>