Community articleRetrieving a community
Added by IBM contributorIBM on March 14, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

To retrieve a community entry, use the edit link for the community entry which can be found in the my communities feed.
Tags: commapi
-
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. If you want to retrieve a feed, see Getting Communities feeds.

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

Input

None.

Output

An Atom entry document containing the community entry.
Input
Method URI Description
GET /communities/service/atom/community/instance 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.
Name Type Optional Description
communityUuid
string No The UUID of the community you wish to retrieve.
Output
Content Type: application/atom+xml
Code Description
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.
401
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.
404
Not Found.
Examples

Response returned by the server
<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>