Authentication

DRN API requests are authorized by using the secret API key.

You can create one in your Fingerprint Dashboard by visiting API Keys.

Your secret API keys can be used query sensitive information about Android devices, be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, or with AI tools.

Authentication is done with Bearer authentication (also called token authentication), and it involves providing the secret API key in a HTTP header. Use the Authorization header to authenticate requests to the DRN API.

Authorization: Bearer SECRET_API_KEY

cURL

curl --request GET \
  --url 'https://drn-api.fpjs.io/drn/{visitor-id-from-your-app}?signals=regional_activity' \
  --header 'Authorization: Bearer SECRET_API_KEY' \
  --header 'X-API-Version: 2024-09-01'

Requests without a valid Authorization header will return HTTP 401 error:

JSON

// HTTP Status: 401
{
  "error": {
    "code": "secret_key_not_found",
    "message": "secret key not found"
  }
}

This error will be returned if a correct Authorization header is not provided or when a secret API key is not found.