POST /session/init — документация API ДАРА ОТПЕЧАТОК

POST /session/init

POST /session/init заводит сессию посетителя и возвращает его visitor_uuid: узнан ли он по cookie, восстановлен по устройству или новый.

SDK вызывает этот метод автоматически. Ключ — публичный.

POST https://fp.daratech.ru/api/session/init
Content-Type: application/json
X-API-Key: pk_ВАШ-ПУБЛИЧНЫЙ-КЛЮЧ

{
  "visitor_uuid":      "<UUID из cookie dara_visitor>",
  "session_uuid":      "<UUID вкладки>",
  "fingerprint_data":  { "canvasFp": "…", "gpuRenderer": "…", "screen": "1920x1080", … },
  "page_url":          "https://example.com/",
  "user_agent":        "Mozilla/5.0...",
  "screen_resolution": "1920x1080"
}

{
  "success":       true,
  "visitor_uuid":  "0f8c2a4e-…",        // запишите в cookie dara_visitor
  "session_uuid":  "7d1e…",             // uuid сессии вкладки: присланный или новый
  "session_id":    42,
  "match":         "cookie",            // cookie | restored | new
  "confidence":    1.0,                 // 1.0 cookie, 0.9 restored, 0 new
  "is_identified": false,               // есть email или телефон
  "is_ambiguous":  false,               // в истории, вероятно, несколько людей
  "fp_version":    2,
  "merged_from":   null,                // устарело: "fingerprint" при match = restored
  "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", "device_type": "desktop" }
  ]
}

visitor_uuid обязательно в формате UUID, иначе ответ 400. Если uuid принадлежит другому сайту, выдаётся новый. session_uuid в ответе отличается от присланного, если сессия с присланным uuid принадлежит другому посетителю или сайту (вкладка пережила смену cookie): тогда сессия заводится под новым uuid, и его нужно передавать дальше. SDK 4.2 делает это сам.