Add a Social Network to an Identity or Object

Description

This method facilitates adding a Social Network to an Identity or Object. To add a social network its necessary to first call get supported networks method which will specify the available social networks and the parameters required for each one.

HTTP Method

POST

Path

/socialio/{identityId}/{id}

Authentication

Requires an authenticated user.

Parameters

Table 45.  Parameters for " Add a Social Network to an Identity or Object "

NameTypeValue TypeDescription
idPATHStringThe social network ID
identityIdPATHStringThe identityID or objectID for which to add the social network to.
usernameFORMStringThe userId for the selected network.
passwordFORMStringthe password for the social network (if required (see get supported networks )).

Error Codes

150001 ( Common )

The endpoint requires an authenticated account

70000 ( SocialIO )

An unhandled exception has occured.

70001 ( SocialIO )

An invalid social network ID was provided.

70011 ( SocialIO )

There is already a social network pointing to the same profile!

70014 ( SocialIO )

The user ID is not valid for this network!

70018 ( SocialIO )

This account does not have access to the object 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="response">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="success" type="tns:Status" default="FAILURE" minOccurs="0"/>
        <xs:element name="error" type="tns:Error" nillable="true" minOccurs="0" maxOccurs="unbounded"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>

  <xs:complexType name="Error">
    <xs:sequence>
      <xs:element name="code" type="xs:string"/>
      <xs:element name="description" type="xs:string"/>
    </xs:sequence>
  </xs:complexType>

  <xs:simpleType name="Status">
    <xs:restriction base="xs:string">
      <xs:enumeration value="SUCCESS"/>
      <xs:enumeration value="FAILURE"/>
    </xs:restriction>
  </xs:simpleType>
</xs:schema>

Sample Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response xmlns="http://xsd.poken.com">
	<success>SUCCESS</success>
</response>