Documentation

GetPlayFabIDsFromGenericIDs

Retrieves the unique PlayFab identifiers for the given set of generic service identifiers. A generic identifier is the service name plus the service-specific ID for the player, as specified by the title when the generic identifier was added to the player account.

Request Details

GetPlayFabIDsFromGenericIDsRequest
Request Properties
GenericIDs (required) List<GenericServiceId>

Array of unique generic service identifiers for which the title needs to get PlayFab identifiers. Currently limited to a maximum of 10 in a single request.

POST https://{{TitleID}}.playfabapi.com/Server/GetPlayFabIDsFromGenericIDs
    Content-Type: application/json
    X-SecretKey: <developer_secret_key>
{
  "GenericIDs": [
    {
      "ServiceName": "BigBizSocial",
      "UserId": "1234567890"
    },
    {
      "ServiceName": "VeeCeeMe",
      "UserId": "og5igh85gf43gf"
    }
  ]
}
        

Response Details

For generic service identifiers which have not been linked to PlayFab accounts, null will be returned.

GetPlayFabIDsFromGenericIDsResult
Result Properties
Data List<GenericPlayFabIdPair>

Mapping of generic service identifiers to PlayFab identifiers.

Sample Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
  "code": 200,
  "status": "OK",
  "data": {
    "Data": [
      {
        "GenericId": {
          "ServiceName": "BigBizSocial",
          "UserId": "1234567890"
        },
        "PlayFabId": "ABCDEF0123456789"
      },
      {
        "GenericId": {
          "ServiceName": "VeeCeeMe",
          "UserId": "og5igh85gf43gf"
        },
        "PlayFabId": "1234567890ABCDEF"
      }
    ]
  }
}

Authentication

SecretKey

Possible Error Codes

Name Code
AccountNotFound 1001