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"
}
]
}
}
}
}
}