Share via

User Verification service

  • Article

App providers can use the User Verification service to confirm that the correct (paying) customer is signing in to the App. This confirmation takes place via two steps:

  1. The API makes a POST call to generate a verification token when the user launches an app within. Verification tokens expire after two minutes for security purposes.
  2. The app makes a GET call using the verification token that is sent by Xandr when the app is launched to retrieve the user's ID. Once the verification token is used to return a user ID, the token is deleted for security purposes.

REST API

HTTP Method Endpoint Description
POST https://api.appnexus.com/user-verification Create a new verification token.
GET https://api.appnexus.com/user-verification?user_token=USER_TOKEN Retrieve the user ID associated with a verification token.

JSON fields

Field Type Description
user_id int The ID of the user that generated the user_token on POST.
user_token string The authentication token that can be used to retrieve a user's ID.

Examples

Create a new verification token

$ curl -b cookies -c cookies -X POST 'https://api.adnxs.com/user-verification'
{
  "response": {
    "status": "OK",
    "user_token": "3e3088b48c901a6b26dc95e530bc5a8c96b8f7e4d6ba46cf"
  }
}

Retrieve the user ID associated with a token

$ curl -b cookies -c cookies 'https://api.adnxs.com/user-verification?user_token=3e3088b48c901a6b26dc95e530bc5a8c96b8f7e4d6ba46cf'
{
  "response": {
    "status": "OK",
    "user_id": 110,
  }
}