Scores a single form/page's mouse-and-keystroke timing summary (produced by the WSInteractionTelemetry.summarize() JS helper) for signs of scripted/automated submission.

Parameters

Field	Type	Optional	Description
`time_to_first_interaction_ms`	number	Optional	—
`time_to_submit_ms`	number	Optional	—
`mouse_move_count`	number	Optional	—
`mouse_move_interval_stdev_ms`	number	Optional	Low variance across mouse-move timing is a strong automation signal.
`keystroke_count`	number	Optional	—
`keystroke_dwell_avg_ms`	number	Optional	—

Every parameter here is optional.

Example Request

curl -X POST http://localhost/api/v1/interaction/check \
  -H "Authorization: Bearer wsk_xxx_xxx"

<?php
$ch = curl_init('http://localhost/api/v1/interaction/check');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer wsk_xxx_xxx']);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

import requests

response = requests.post("http://localhost/api/v1/interaction/check",
    headers={"Authorization": "Bearer wsk_xxx_xxx"},
)

data = response.json()

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	client := &http.Client{}
	req, _ := http.NewRequest("POST", "http://localhost/api/v1/interaction/check", nil)
	req.Header.Set("Authorization", "Bearer wsk_xxx_xxx")

	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	respBody, _ := io.ReadAll(resp.Body)
	fmt.Println(string(respBody))
}

Example Response

{
  "data": {
    "is_suspected_automated": false,
    "fraud_score": 0, "risk_score": 0,
    "reasons": ["No automation timing signals detected"]
  }
}

← Behavior / Velocity Check Session Telemetry Beacon →