3002: Get social connection

3002: Get social connection

Returns information about a specific connection between a given account and a social media.

 

Endpoint ID:

3002

Method:

GET

URL:

/entity/id/{entity-id}/social-connections/{id}

/entity/ext-key/{ext-key}/{ext-type}/social-connections/{id}

 

 

entity-id

Rubiq entity ID that uniquely identifies an account to get social connection for

 

ext-key

External key that uniquely identifies an account to get social connection for

 

ext-type

Type of external key

 

id

Social connection to retrieve

Request body:

None

JSON data with information about the social connection specified by id for the given account

Example – Account is connected to the social media identified by id and the social media is Facebook:
{ "id": 1234, "type": "facebook", "appID": 987654321, "userID": 123456789, "accessToken": "...", "accessTokenExpires": "..." }

Status codes:

200

Success

 

404

Account was not found or has no social connection with the specified id

 The following sub codes may be returned:

404.1

User not found

404.2

External user could not be found

404.5

Connection not found

404.6

Connection does not match user