UIID
UIID Menu
v2.21 Module

First Shot Feature (FSF).

Get a first assessment of a visitor: is it likely a human, a known crawler, or automation, and how much to trust the request. FSF runs only after the visitor explicitly agrees, and it never installs anything on the device.

For End Users

  • FSF asks for your consent before it runs. Without consent, no fingerprint is computed.
  • Only the verdict and a trust score are returned to the site; the raw browser signals are not kept by the platform.
  • FSF does not profile you or track your activity across sites.

Company Setup

  1. Add a consent prompt to your page and call assessVisitor only after the visitor clicks allow.
  2. The client library loads FingerprintJS OSS, ThumbmarkJS and BotD from /js/vendor/fsf/ on your UIID host; no build step is needed.
  3. Read the JSON result: verdict (human, bot, declared_agent, suspicious, unknown), trust_score (0-100) and reasons.
  4. Server side, the endpoint POST /api/v1/fsf/assess returns 403 without consent:true. Only trust JA4 headers if a reverse proxy you control sets them (FSF_TRUST_JA4_HEADER=true).
  5. Browsers must not hold your API key. Point assessVisitor at your own backend (endpoint option), which forwards the request to /api/v1/fsf/assess with your X-API-Key.
  6. Treat the trust score as a signal, not a decision: combine it with your own rules.

Example

<script type="module">
import { assessVisitor } from '/js/uiid-fsf.js';

// Call only after the visitor clicked "Allow"
const result = await assessVisitor({ consent: visitorAllowed });
console.log(result.verdict, result.trust_score, result.reasons);
</script>

Need code tailored to your stack? Generate ready-to-paste examples in the Developer Modules generator.

Use via API

This module is metered through the UIID API. Create an API key in your dashboard, grant it the scope fsf:assess, and send it as the X-API-Key header. Requests without a key get 401; keys without the scope get 403.

  • POST /api/v1/fsf/assess body {"consent":true,"client":{...browser signals}} returns verdict, trust_score, reasons
  • Without consent:true the endpoint answers 403 and computes nothing.

cURL

curl -X POST https://idp.uiid.linkspreed.com/api/v1/fsf/assess \
  -H "X-API-Key: $UIID_API_KEY" -H "Content-Type: application/json" \
  -d '{"consent":true,"client":{"webdriver":false,"platform":"Linux x86_64","hardware_concurrency":8}}'

Full request and response reference: FSF in the API docs.