Документация

ДАРА ОТПЕЧАТОК — облачный сервис идентификации посетителей. Один тег <script> — и вы получаете стабильный visitorId для каждого устройства.

Быстрый старт

<script src="https://fingerprint.daratech.ru/sdk/dara-fingerprint.js"></script>
<script>
  DaraFingerprint.init({
    apiUrl: 'https://fingerprint.daratech.ru/api',
    apiKey: 'ВАШ-API-КЛЮЧ'
  });
</script>

Конфигурация

Параметры DaraFingerprint.init(options):

Как работает

При загрузке страницы SDK собирает сигналы браузера и устройства, вычисляет SHA-256 хеш и отправляет его на сервер. Сервер возвращает стабильный visitorId.

Если тот же отпечаток встречается с нового браузера или после очистки истории — посетитель всё равно будет опознан. Уверенность идентификации: 0.95.

Сигналы

SDK собирает более 20 параметров браузера и устройства:

• User-Agent, платформа, язык интерфейса
• Разрешение экрана, colorDepth, devicePixelRatio
• Таймзона (смещение + IANA-название)
• CPU: количество ядер
• GPU: WebGL Renderer и Vendor
• Canvas fingerprint — уникален для каждой связки GPU + ОС + браузер
• Math fingerprint — тригонометрические функции с платформенными отличиями
• Наличие touch-экрана, количество точек касания
• Количество установленных плагинов браузера

Все сигналы объединяются и хешируются SHA-256. Полученный хеш — это visitorId.

API — идентификация

SDK вызывает этот эндпоинт автоматически. Вы также можете обращаться к нему напрямую:

POST https://fingerprint.daratech.ru/api/session/init
Content-Type: application/json
X-API-Key: ВАШ-API-КЛЮЧ

{
  "visitor_uuid":     "<fingerprint-hash>",
  "session_uuid":     "<случайный UUID для текущей вкладки>",
  "fingerprint":      "<fingerprint-hash>",
  "page_url":         "https://example.com/",
  "user_agent":       "Mozilla/5.0...",
  "screen_resolution":"1920x1080",
  "timezone":         "Europe/Moscow"
}

Ответ

{
  "success":       true,
  "visitor_uuid":  "a3f2c1d4e5...",   // стабильный visitorId
  "session_id":    42,
  "is_identified": true,              // true = посетитель уже встречался
  "visit_count":   7,                 // сколько раз видели этот отпечаток
  "first_visit":   "2026-04-12 09:23:11",
  "recent_visits": [
    {
      "date":        "2026-05-24 14:00:00",
      "browser":     "Chrome",
      "os":          "Windows 10/11",
      "device_type": "desktop"
    }
  ]
}

Базовое подключение

<script src="https://fingerprint.daratech.ru/sdk/dara-fingerprint.js"></script>
<script>
  DaraFingerprint.init({
    apiUrl: 'https://fingerprint.daratech.ru/api',
    apiKey: 'ВАШ-API-КЛЮЧ'
  });
</script>

С callback

DaraFingerprint.init({
  apiUrl: 'https://fingerprint.daratech.ru/api',
  apiKey: 'ВАШ-API-КЛЮЧ'
}).onReady(function(result) {
  console.log('visitorId:',    result.visitor_uuid);
  console.log('Визитов:',      result.visit_count);
  console.log('Уже видели:',   result.is_identified);
});

PHP

Получить данные о посетителе на сервере по fingerprint hash, переданному из JS:

// JS → PHP: передайте visitorId через скрытое поле или AJAX
$visitorId = $_POST['visitor_id'] ?? null;

if ($visitorId) {
    $ch = curl_init('https://fingerprint.daratech.ru/api/visitor/info');
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER     => [
            'Content-Type: application/json',
            'X-API-Key: ВАШ-API-КЛЮЧ'
        ],
        CURLOPT_POSTFIELDS => json_encode([
            'visitor_uuid' => $visitorId
        ])
    ]);
    $result = json_decode(curl_exec($ch), true);
    curl_close($ch);

    $visitCount  = $result['visitor']['total_visits'] ?? 0;
    $isRecurring = $result['visitor']['is_identified'] ?? false;
}