Retrieve a community
To retrieve a community entry, use the edit link for the community entry which can be found in the my communities feed.You can use this operation to obtain community entry information that you want to preserve prior to performing an update. See Update communities for more information. This method returns the Atom entry of a single community as opposed to a feed of the community. If you want to retrieve a feed, see Getting Communities feeds.
See Authenticating requests for information about how to authenticate the request.
Table 1. Atom API request details
Method Resource URI Output representation GET community
- Value of the href attribute of <link> element that has a rel="edit" attribute for each entry in the my communities feed.
- web address returned in the HTTP location header when the community was created.
community
Input
None.
Output
An Atom entry document containing the community entry.Returned HTTP headers
HTTP/1.1 200 OK
Indicates that the community entry was successfully found and returned. If an error occurs, this header will contain one of the error codes below.
Content-Type: application/atom+xml
Indicates that the document returned contains data in Atom format.
- HTTP/1.1 401 Unauthorized
- HTTP/1.1 404 Not Found
Sample ouptut:
<entry xmlns:snx="http://www.ibm.com/xmlns/prod/sn" xmlns:app="http://www.w3.org/2007/app" xmlns="http://www.w3.org/2005/Atom"> <id>http://communities.ibm.com:2006/service/atom/community/instance? communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22</id> <title type="text">Intraknut users community</title> <summary type="text"> Discuss tips and tricks for using the Intraknut product to create web applications </summary> <content type="html"> Discuss tips and tricks for using the Intraknut product to create web applications<br> </content> <published>2009-07-17T16:46:49.312Z</published> <author> <name>Rik Smith</name> <email>rsmith@us.example.com</email> <snx:userid xmlns:snx="http://www.ibm.com/xmlns/prod/sn"> 5b788f40-7d67-102c-845c-e2ebc3ec5536 </snx:userid> </author> <updated>2009-07-17T17:41:07.968Z</updated> <contributor> <name>Sue Goodman</name> <email>sgoodman@us.example.com</email> <snx:userid xmlns:snx="http://www.ibm.com/xmlns/prod/sn"> 5adff8c0-7d67-102c-845a-e2ebc3ec5536 </snx:userid> </contributor> <category term="community" scheme="http://www.ibm.com/xmlns/prod/sn/type" /> <link href="https://enterprise.example.com:9445/communities/service/atom/community/ instance?communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22" rel="self" /> <link href="https://enterprise.example.com:9445/communities/service/atom/community/ instance?communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22" rel="edit" /> <link href="https://enterprise.example.com:9445/communities/service/html/ communityview?communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22" rel="alternate" type="text/html" /> <link href="https://enterprise.example.com:9445/communities/service/html/image? communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22&lastMod=1247852467968" rel="http://www.ibm.com/xmlns/prod/sn/logo" /> <link href="https://enterprise.example.com:9445/communities/service/atom/community/ service?communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22" rel="http://www.ibm.com/xmlns/prod/sn/service" type="application/atomsvc+xml" /> <link href="https://enterprise.example.com:9445/communities/service/atom/community/ members?communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22" rel="http://www.ibm.com/xmlns/prod/sn/member-list" type="application/atom+xml" /> <link href="https://enterprise.example.com:9445/communities/service/atom/community/ bookmarks?communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22" rel="http://www.ibm.com/xmlns/prod/sn/bookmarks" type="application/atom+xml" /> <link href="https://enterprise.example.com:9445/communities/service/atom/community/ feeds?communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22" rel="http://www.ibm.com/xmlns/prod/sn/feeds" type="application/atom+xml" /> <link href="https://enterprise.example.com:9445/communities/service/atom/community/ remoteApplications?communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22" rel="http://www.ibm.com/xmlns/prod/sn/remote-applications" type="application/atom+xml" /> <link href="https://enterprise.example.com:9445/communities/service/atom/community/ forum/topics?communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22" rel="http://www.ibm.com/xmlns/prod/sn/forum-topics" type="application/atom+xml" /> <snx:membercount xmlns:snx="http://www.ibm.com/xmlns/prod/sn"> 2 </snx:membercount> <snx:communityType xmlns:snx="http://www.ibm.com/xmlns/prod/sn"> public </snx:communityType> </entry>
Parent topic
Work with communities programmaticallyRelated concepts
Getting Communities feedsRelated reference
Update communities
Community entry content
});