Get Social Networks for Identity

Description

Each account in the Poken System may have one or more identities associated with it. An identity may have zero or many Social Networks associated with it. This method returns the details of all the social networks which have been associated to a given identity for the users account.

HTTP Method

GET

Path

/socialio/details/{identityId}

Authentication

Does not require user authentication.

Parameters

Table 43.  Parameters for " Get Social Networks for Identity "

NameTypeValue TypeDescription
identityIdPATHStringThe identityID for which to retrieve the social networks for.
contextCampaignIdQUERYlong(optional) The id of the campaign in which the social networks should be retrieved. To be used for the case when the logged in user has permissions on that campaign and should be able to view this information.

Error Codes

70000 ( SocialIO )

An unhandled exception has occured.

70002 ( SocialIO )

This account does not have access to the identity specified.

Response Schema

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema elementFormDefault="qualified" version="1.0" targetNamespace="http://xsd.poken.com" xmlns:tns="http://xsd.poken.com" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="socialNetworkDetails">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="socialNetworkDetail" type="tns:SocialNetworkDetail" nillable="true" minOccurs="0" maxOccurs="unbounded"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>

  <xs:complexType name="SocialNetworkDetail">
    <xs:sequence>
      <xs:element name="id" type="xs:long"/>
      <xs:element name="socialNetworkId" type="xs:long"/>
      <xs:element name="nameId" type="xs:string"/>
      <xs:element name="addFriendUrl" type="xs:string"/>
      <xs:element name="viewFriendUrl" type="xs:string"/>
      <xs:element name="loginParameters">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="loginParameter" type="tns:LoginParameter" nillable="true" minOccurs="0" maxOccurs="unbounded"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:sequence>
  </xs:complexType>

  <xs:complexType name="LoginParameter">
    <xs:sequence>
      <xs:element name="name" type="xs:string"/>
      <xs:element name="value" type="xs:string"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>

Sample Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<socialNetworkDetails xmlns="http://xsd.poken.com">
  <socialNetworkOrder>1246631443981,1246631469717</socialNetworkOrder>
  <socialNetworkDetail>
    <id>1246631443981</id>
    <socialNetworkId>30</socialNetworkId>
    <nameId>twitter</nameId>
    <addFriendUrl></addFriendUrl>
    <viewFriendUrl>http://twitter.com/test_poken_app
    </viewFriendUrl>
    <loginParameters>
      <loginParameter>
        <name>NAME</name>
        <value>test_poken_app</value>
      </loginParameter>
    </loginParameters>
  </socialNetworkDetail>
  <socialNetworkDetail>
    <id>1246631469717</id>
    <socialNetworkId>30</socialNetworkId>
    <nameId>twitter</nameId>
    <addFriendUrl></addFriendUrl>
    <viewFriendUrl>http://twitter.com/test_poken_app1
    </viewFriendUrl>
    <loginParameters>
      <loginParameter>
        <name>NAME</name>
        <value>test_poken_app1</value>
      </loginParameter>
    </loginParameters>
  </socialNetworkDetail>
</socialNetworkDetails>