Handles the evaluation of risk associated with bot activities, enabling the detection and prevention of automated or malicious actions that could compromise system integrity.

Bot Risk API

The Bot Risk API is designed to help organizations identify and mitigate automated and malicious activities. This endpoint evaluates the risk associated with bot actions, providing a risk score and severity level based on various indicators. By integrating this API, organizations can detect and prevent bot-driven activities that could compromise system integrity and user experience. The API enhances security measures by enabling immediate responses to high-risk bot actions, thereby protecting the organization's digital assets and maintaining a secure online environment.

Request Structure

Endpoint: /v1/bot

Hostname: https://a.sensfrx.ai

Method: POST

Headers:

Authorization: Basic Auth encoded in Base64.
Content-Type: application/json

Request Body:

{
  "uID": "15",
  "dID": "Device-JWT-USER-ID",
  "h": {
    "ip": "45.252.1.123",
    "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/105.0.0.0 Safari/537.36",
    "ho": "demo.sensfrx.ai",
    "rf": "https://demo.sensfrx.ai/register.php",
    "ac": {
      "a": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9",
      "ae": "gzip, deflate, br",
      "al": "en-US,en;q=0.9,hi;q=0.8,mr;q=0.7"
    },
    "url": "http://demo.sensfrx.ai/register.php"
  }
}

POST Parameters:

uID (string): Unique identifier for the user and this supplied from application.
dID (string): Unique identifier for the device.
timestamp (string): The time of the registration attempt in ISO 8601 format.
h (object): Header information.
- ip (string): IP address of the user.
- ua (string): User agent string.
- ho (string): Hostname of the registration page.
- url (string): URL of the registration page.

Response

{
    "status": "allow",
    "severity": "low",
    "risk_score": 11,
    "shadow_mode": "0",
    "device": {
        "device_id": "dFQjCFRjDA5Q%2Fb8pL0CKFgiGWFJOhhtLNXknQHwVlEYwbxu%2B4ojymgjLJ91KBuRxA%2Bh83yCCjXqycQOPbtvLcc64kcgG8h3e%2BuaqRfWkD2U0NwgFfRbVFz4PA7mjQoyLybhTcGBETr5j4xED0pndUXFSNtRRviDc%2FmluS8y18Z4tnqXDcYuiz%2BxlAMSA",
        "name": "Chrome on Windows 10",
        "ip": "45.252.74.134",
        "location": "Aurangabad, MH, IN"
    },
    "message": "Bot Request successfully reached."
}