Identity API \ Read the details of an identity PHP SDK
Identity API Resources
Resource/URI - Common | GET | POST | PUT | DELETE |
---|---|---|---|---|
Identities
/identities.json
|
List all identities | – | – | – |
Identity
/identities/<identity_token>.json
|
Read identity details | – | – | Delete identity |
Identity
/identities/<identity_token>/link.json
|
– | – | ReLink identity | – |
Identity
/identities/<identity_token>/synchronize.json
|
– | – | Synchronize identity | – |
Identity
/identities/<identity_token>/contacts.json
|
Read identity contacts | – | – | – |
Resource/URI - Provider Specific | GET | POST | PUT | DELETE |
---|---|---|---|---|
Steam Games
/identities/<identity_token>/steam/games.json
|
List all Steam games | – | – | – |
Facebook Posts
/identities/<identity_token>/facebook/posts.json
|
List all Facebook posts | – | – | – |
Workflow
Request: the code to send to the API
Send a GET
request to the resource /identities/<identity_token>.json
to retrieve the details of an identity.
The <identity_token>
has to be replaced by the unique token of an existing identity.
Result: the code returned by the API
The API returns the details of the corresponding identity; it represents a collection of user information like for example the social network profile of a person. Please refer to the following page for a complete list of possible values for the identity node.
Example Resultset
{ "response": { "request": { "date": "Mon, 06 Oct 2014 11:05:21 +0200", "resource": "/identities/1b93e09a-4cd3-4c5c-9081-2cb1eaa53573.json", "status": { "flag": "success", "code": 200, "info": "Your request has been processed successfully" } }, "result": { "data": { "identity": { "user_token": "15ad071c-6a64-4ce1-a9df-72f506161636", "identity_token": "1b93e09a-4cd3-4c5c-9081-2cb1eaa53573", "provider": "facebook", "source": { "name": "Facebook", "key": "facebook", "access_token": { "key": "zgv7iJkWNBuyWMmrCzuz9oqo2rXEE3YUU3om559Q36bMZZYK73KofXBSpFFeZGRmYFgzbtUhMZBkesyZzgv7iJkWNBuyWMmrCzuz9oqo2rXEE3YUU3om559Q36bMZZYK73KofXBSpFFeZGRmYFgzbtUhMZBkesyZ" } }, "id": "http://www.facebook.com/profile.php?id=1", "displayName": "John Doe", "name": { "formatted": "John Doe", "givenName": "John", "familyName": "Doe" }, "preferredUsername": "john.doe", "profileUrl": "https://www.facebook.com/john.doe", "thumbnailUrl": "http://graph.facebook.com/1/picture?type=square", "pictureUrl": "http://graph.facebook.com/1/picture?type=large", "gender": "male", "birthday": "01/01/1965", "utcOffset": "2:00", "emails": [ { "value": "john.doe@example.com", "is_verified": true } ], "urls": [ { "value": "https://www.facebook.com/john.doe", "type": "profile" } ], "accounts": [ { "domain": "facebook.com", "userid": "1", "username": "john.doe" } ], "photos": [ { "value": "http://graph.facebook.com/1/picture?type=square", "size": "2:XS" }, { "value": "http://graph.facebook.com/1/picture?type=small", "size": "3:S" }, { "value": "http://graph.facebook.com/1/picture?type=normal", "size": "4:M" }, { "value": "http://graph.facebook.com/1/picture?type=large", "size": "5:L" } ], "languages": [ { "value": "English", "type": "other" }, ], "organizations": [ { "name": "John Doe Inc", "location": "New York, United States", "title": "CEO & Founder", "description": "John Doe Inc provides names for anonymous character", "startDate": "2000-01" } ] } } } } }