API Guide v2.0

Get User's Network

HTTP Method & URL
GET <base-url>?Type=MyNetwork&Version=1&UserId=<userid>& Page=<page#>
Parameters
Type <Required> Type of the request resource
Version <Required> API version#
UserId <Required> UserID of the user whose network members you want to retrieve.
age <optional> Page# (starts with 1) of the results. Defaults to 1st page.
Description
Returns the list of all members in the user's network.
Example Response
<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <TimeStamp> 2008-03-25 05:29:30 GMT </TimeStamp>
  <APIVersion> 1.0 </APIVersion>
  <CurrentPage> 1 </CurrentPage>
  <TotalPages> 6 </TotalPages>
  <PageSize> 10 </PageSize>
  <Users>
    <CommunityUser>
      <User> 
        <UserName> Joe Doe </UserName>
        <Id> 4 </Id>
        <Email> jdoe@mycompany.com </Email>
      </User>
      <PopularTags>
        <Tag>
          <Keyword> Web 2.0 </Keyword>
          <Id> 35 </Id>
          <Weight> 0 </Weight>
		  <DateWeight> 0 </DateWeight>
		  <TagCount> 0 </TagCount>
        </Tag> 
        <Tag>
          <Keyword> UI Design </Keyword>
          <Id> 36 </Id>
          <Weight> 0 </Weight>
		  <DateWeight> 0 </DateWeight>
		  <TagCount> 0 </TagCount>
        </Tag> 
      </PopularTags> 
      <CommonPopularTags> 
        <Tag>
          <Keyword> Web 2.0 </Keyword>
          <Id> 35 </Id>
          <Weight> 0 </Weight>
		  <DateWeight> 0 </DateWeight>
		  <TagCount> 0 </TagCount>
        </Tag> 
      </CommonPopularTags> 
      <Expertise> 
        <UserTag>
          <Keyword> Analytics </Keyword>
          <Id> 36 </Id>
        </UserTag> 
        <UserTag>
          <Keyword> Biking </Keyword>
          <Id> 37 </Id>
        </UserTag> 
      </Expertise> 
      <CommonExpertise> 
        <UserTag>
          <Keyword> Biking </Keyword>
          <Id> 37 </Id>
		</UserTag> 
      </CommonExpertise>   
	  <Interests> 
        <UserTag>
          <Keyword> Running </Keyword>
          <Id> 154 </Id>
        </UserTag> 
      </Interests> 
      <CommonInterests> 
        <UserTag>
          <Keyword> Running </Keyword>
          <Id> 154 </Id>
		</UserTag> 
      </CommonInterests>
	  <Projects> 
        <UserTag>
          <Keyword> 3D Visualization </Keyword>
          <Id> 106 </Id>
        </UserTag> 
      </Projects> 
      <CommonProjects> </CommonProjects>  
	  <SharedCommunities> 
        <Community>
          <Name> News Community </Name>
          <Id> 333 </Id>
          <Description> Community for the Current World News </Description> 
          <BookmarkCount> 0 </BookmarkCount>
          <UserCount> 0 </UserCount>
          <CreatedBy> unkown </CreatedBy>
          <CreatedOn> unknown </CreatedOn>
        </Community>
      </SharedCommunities>
    </CommunityUser>
  </Users>
</Response>
Notes:
  • PopularTags: List of tags as shown in the Popular Tags field in the My Connections UI
  • CommonPopularTags: List of tags as shown in the Common With Me field (of Popular Tags section) in the My Connections UI. These are the popular tags that are common between the group user/member and user specified in the Web Service request. If there are no common popular tags (empty list), then this element does not contain any child <Tag> elements
  • Expertise: List of tags as shown in the Expertise field in the My Connections UI for the group user/member.
  • CommonExpertise: List of tags as shown in the Common With Me field (of Expertise section) in the My Network UI. These are the tags that are common between the group user/member and user specified in the Web Service request. If there are no common tags (empty list), then this element does not contain any child <Tag> elements.
  • UserCount: Number of users/members that are part of that group. The value will always be "0" for Version 1 of the APIs.
  • The values for <CreatedBy> & <CreatedOn> could be "unknown" in Version 1 API.
  • BookmarkCount: Number of bookmarks that are part of that group. The value will always be "0" for Version 1 of the APIs.


Changes from v1.0
  • XML response has been updated
  • UserTags has been modified to Expertise, and Interests and Projects have been added as new fields
  • CommonUserTags is no CommonExpertise

back to top

©2008 Connectbeam, Inc.