v1

latestOpenAPI 3.0.32026-07-248519153.1 KB

Identify user by fingerprint

Same identification flow as GET, but optional fingerprint fields are sent in the request body. Required inputs are still api_key and User-Agent headers.

post/user/identify

Headers

api_keystring required

API key for authentication.

Example:w2w_test_api_key_12345

User-Agentstring required

Client user agent used for fingerprint matching.

Example:Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0 Mobile Safari/537.36

platformstring

Device/platform for fingerprint matching (e.g. ios, android, web).

Example:Android

Request body

screen_sizestring

Device screen size for fingerprint matching.

timezonestring

Client timezone for fingerprint matching.

os_versionstring

OS version for enhanced fingerprint matching.

Example request

{
  "screen_size": "1080x2400",
  "timezone": "UTC+02:00",
  "os_version": "Android 14"
}

Response

Identification result (user found or not).

success0 | 1

1 if a user was identified, 0 otherwise.

user_idstring nullable

Identified user GUID, or null if no match.

match_methodstring

How the user was matched (e.g. IP, fingerprint).

platformstring nullable

Detected or provided platform.

messagestring

Present when success is 0 (e.g. "User not found by fingerprint").

errorinteger

Present on failure (1).

error_msgstring

Error message when error is 1 (e.g. missing IP/User-Agent).