Web SDK API Reference

@keverdjs/agent (vanilla JavaScript). For React use @keverdjs/react, Vue @keverdjs/vue, Angular @keverdjs/angular.

`Keverd.init(apiKey | config)`

Initialize the SDK. Call once before get(). Parameters:

Option	Type	Required	Description
`apiKey`	string	Yes	Your public API key (`pk_live_` or `pk_test_`)
`endpoint`	string	No	Backend URL; default `https://api.keverd.com`
`userId`	string	No	User identifier to attach to requests
`debug`	boolean	No	Enable debug logs; default `false`

Examples:

javascript

Keverd.init('YOUR_PUBLIC_API_KEY');

Keverd.init({ apiKey: 'YOUR_PUBLIC_API_KEY', endpoint: 'https://api.keverd.com', debug: false });

Collect device/visitor data and return a result. Call on page load or at key events (login, checkout). Returns: Promise<GetResult> Example:

javascript

const result = await Keverd.get();
console.log(result.event_id, result.visitor_id);

Property	Type	Description
`event_id`	string	Unique ID for this request/event
`visitor_id`	string	Persistent device/visitor identifier
`risk_score`	number	Risk score (0–100), when available
`action`	string	`'allow'`, `'challenge'`, or `'block'`, when available
`reason`	string[]	Reason codes, when available
`session_id`	string	Session identifier, when available
`requestId`	string	Request ID, when available