Verify API

Verify your tokens.

Endpoint

POST https://hamutan86.pythonanywhere.com/nonstress/api/verify

Request

token · string

the nonstress token you received from client-side.

Verified

JSON

{
  "token": "a5Eg2Jqjh+F177T3wmnSbarx72Qxbkz8YjZH..."
}

Response

error · string / null

will be the error text when an error occurred in verification

security[pass] · boolean

Did the user passed our verification or not.

security[score] · float

the suspicion score of user. higher score = more human, lower score = more bot. (0.0-1.0)

security[url] · string

the url where the token generated. you can block user if url didn’t match with your expect.

user[device_fingerprint] · string

user’s device fingerprint ID.

user[device_values] · JSON

Pro Plan Only; user’s device fingerprint values.

user[ip] · string

user’s IP address.

user[user-agent] · string

user’s User-Agent header.

Verified

{
    "error": null,
    "security": {
        "pass": true,
        "score": 1.0,
        "url": "https://hamutan86.pythonanywhere.com/nonstress/demo"
    },
    "user": {
        "device_fingerprint": "677d41785ab...",
        // "device_values": {"lang": "en"...}, (Pro Plan Only)
        "ip": "1.2.3.4",
        "user-agent": "Mozilla/5.0 (Windows NT 10.0; ..."
    }
}

Error

{
    "error": "invalid token",
    "security": {
        "pass": false
    }
}

Bot Detected

{
    "error": null,
    "security": {
        "pass": false,
        "score": 0.0,
        "url": "https://hamutan86.pythonanywhere.com/nonstress/demo"
    },
    "user": {
        "device_fingerprint": "b9d721c204a...",
        // "device_values": {"lang": "en"...}, (Pro Plan Only)
        "ip": "4.3.2.1",
        "user-agent": "Mozilla/5.0 (Windows NT 10.0; ..."
    }
}