POST
/
v1
/
device
/
check
Device Check
curl --request POST \
  --url https://api.sentineltrustplay.io/v1/device/check \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'X-Game-Id: <x-game-id>' \
  --data '
{
  "device_id": "<string>",
  "publisher_id": "<string>",
  "game_id": "<string>",
  "alg": "<string>",
  "payload_b64": "<string>",
  "sig_b64": "<string>"
}
'
{
  "device_id": "dvc_abc123",
  "publisher_id": "pub_acme",
  "game_id": "game_fps_01",
  "banned": false,
  "bans": {
    "cheat": { "active": 0, "inactive": 0, "total": 0 },
    "social": { "active": 0, "inactive": 0, "total": 0 }
  },
  "reputation": {
    "cheat_score": 0.0,
    "social_score": 0.0
  },
  "status": "ok"
}
​
Authorization
string
required
API key as Bearer token: Bearer sni_<your-key>. Sent by client.
​
X-Game-Id
string
required
Game identifier. Sent by client.
​
device_id
string
required
The device identifier to check.
​
publisher_id
string
required
The publisher identifier associated with this API key.
​
game_id
string
required
Must match the X-Game-Id header.
​
alg
string
required
Signature algorithm. Currently only ES256 is supported.
​
payload_b64
string
required
Base64-encoded signed payload JSON containing ts_unix_ms, jti, device_fw, and telemetry.
​
sig_b64
string
required
Base64-encoded ECDSA signature over the raw payload bytes.
{
  "device_id": "dvc_abc123",
  "publisher_id": "pub_acme",
  "game_id": "game_fps_01",
  "banned": false,
  "bans": {
    "cheat": { "active": 0, "inactive": 0, "total": 0 },
    "social": { "active": 0, "inactive": 0, "total": 0 }
  },
  "reputation": {
    "cheat_score": 0.0,
    "social_score": 0.0
  },
  "status": "ok"
}