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

Content-Type: application/atom+xml

Error codes

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 programmatically

Related concepts
Getting Communities feeds

Related reference
Update communities
Community entry content


   

 

});