API Documentation

<?php
$apiKey            = 'YOUR_API_KEY';
$userId            = $loggedInUserId;          // your internal user identifier
$sessionId         = session_id();             // your session token
$deviceFingerprint = $myDeviceHash;            // any string unique to this device
$userAgent         = $_SERVER['HTTP_USER_AGENT'];

$query = http_build_query([
    'ip'                 => $_SERVER['REMOTE_ADDR'],
    'user_id'            => $userId,
    'session_id'         => $sessionId,
    'device_fingerprint' => $deviceFingerprint,
    'ua'                 => $userAgent,
]);
$response = file_get_contents("https://affguard.ai/api/v1/ip/lookup?{$query}", false, stream_context_create([
    'http' => ['header' => "X-API-KEY: {$apiKey}"]
]));
$data = json_decode($response, true);

$behavior = $data['behavior'] ?? null;
if ($behavior) {
    foreach ($behavior['signals'] as $signal) {
        if ($signal['type'] === 'ip_rotation_detected' && $signal['confidence'] === 'high') {
            http_response_code(403);
            exit('Suspicious activity detected. Conversion blocked.');
        }
    }
    if ($behavior['session_risk'] >= 70) {
        http_response_code(403);
        exit('High session risk. Conversion blocked.');
    }
}

const axios = require('axios');

const apiKey  = 'YOUR_API_KEY';
const params  = {
  ip:                 req.ip,
  user_id:            req.user.id,
  session_id:         req.sessionID,
  device_fingerprint: req.body.deviceHash,   // you compute this
  ua:                 req.headers['user-agent'],
};

const { data } = await axios.get('https://affguard.ai/api/v1/ip/lookup', {
  params,
  headers: { 'X-API-KEY': apiKey },
});

const behavior = data.behavior;
if (behavior) {
  const rotated = behavior.signals.some(
    s => s.type === 'ip_rotation_detected' && s.confidence === 'high'
  );
  if (rotated || behavior.session_risk >= 70) {
    return res.status(403).json({ error: 'Suspicious activity. Conversion blocked.' });
  }
}

import requests

API_KEY = 'YOUR_API_KEY'
params = {
    'ip':                 request.remote_addr,
    'user_id':            current_user.id,
    'session_id':         session.get('id'),
    'device_fingerprint': request.form.get('device_hash'),   # you compute this
    'ua':                 request.headers.get('User-Agent'),
}

resp = requests.get(
    'https://affguard.ai/api/v1/ip/lookup',
    params=params,
    headers={'X-API-KEY': API_KEY},
)
data = resp.json()

behavior = data.get('behavior')
if behavior:
    signals = {s['type'] for s in behavior.get('signals', []) if s['confidence'] == 'high'}
    if 'ip_rotation_detected' in signals or behavior['session_risk'] >= 70:
        abort(403, 'Suspicious activity. Conversion blocked.')

curl -G "https://affguard.ai/api/v1/ip/lookup" \
  -H "X-API-KEY: YOUR_API_KEY" \
  --data-urlencode "ip=203.0.113.45" \
  --data-urlencode "user_id=user_12345" \
  --data-urlencode "session_id=sess_abc" \
  --data-urlencode "device_fingerprint=YOUR_DEVICE_HASH" \
  --data-urlencode "ua=Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X)"