Identity API \ Read the details of an identity PHP SDK

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

User Contributed Notes