Retrieving a community

Home

Retrieving 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 Updating communities for more information. This method returns the Atom entry of a single community as opposed to a feed of the community. To retrieve a feed, see Searching communities.

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

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

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.

Error codes

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.acme.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.acme.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.acme.com:9445/communities/service/atom/community/
    instance?communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22" 
   rel="self" /> 
  <link 
   href="https://enterprise.acme.com:9445/communities/service/atom/community/
    instance?communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22" 
   rel="edit" /> 
  <link 
   href="https://enterprise.acme.com:9445/communities/service/html/
    communityview?communityUuid=d2fdec09-0221-47fe-a27b-2e55497caa22" 
   rel="alternate" 
   type="text/html" /> 
  <link 
   href="https://enterprise.acme.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.acme.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.acme.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.acme.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.acme.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.acme.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.acme.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>

Working with communities

Related reference

Updating communities

Community entry content