> For the complete documentation index, see [llms.txt](https://docs.femida-search.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.femida-search.tech/fingerprint/integraciya-na-bekende.md).

# Интеграция на бэкенде

#### Запрос по requestID

<table><thead><tr><th width="210"></th><th></th></tr></thead><tbody><tr><td>url</td><td><a href="https://demo.fingerprint-femida-search.ru/fingerprint/events">https://demo.fingerprint-femida-search.ru/fingerprint/events</a></td></tr><tr><td>метод</td><td>POST</td></tr><tr><td>формат ответа</td><td>JSON</td></tr></tbody></table>

Тело запроса (body):

<table><thead><tr><th width="269.3333333333333">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td>request_id</td><td>ID запроса(полученный с фронта)</td></tr><tr><td>token</td><td>Публичный токен(тот же самый, который был передан в скрипт на фронте)</td></tr></tbody></table>

#### Запрос по visitorID

<table><thead><tr><th width="210"></th><th></th></tr></thead><tbody><tr><td>url</td><td><a href="https://demo.fingerprint-femida-search.ru/fingerprint/visitors">https://demo.fingerprint-femida-search.ru/fingerprint/visitors</a></td></tr><tr><td>метод</td><td>POST</td></tr><tr><td>формат ответа</td><td>JSON</td></tr></tbody></table>

Тело запроса (body):

<table><thead><tr><th width="269.3333333333333">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td>visitor_id</td><td>ID пользователя(полученный с фронта)</td></tr><tr><td>token</td><td>публичный токен(тот же самый, который был передан в скрипт на фронте)</td></tr></tbody></table>

Также можно не передавать request\_id/visitor\_id и в ответе вы получите массив всех запросов сделанных с указанным токеном.

Пример ответа:

```
{
  "requestId":"1701856503881.ABCDEF",   
  "url":"http://localhost:3000/",       
  "ip":"0.0.0.0",                       
  "time":"2023-12-06T09:55:03Z",        
  "timestamp":1701856503881,            
  "ipLocation":{                        
    "accuracyRadius":1000,
    "latitude":11.2233,                 
    "longitude":44.5566,
    "timezone":"Europe/Moscow",
    "country":{                         
      "code":"RU",
      "name":"Russia"
    },
    "continent":{
      "code":"EU",
      "name":"Europe"
    }
  },
  "visitorId":"1234567890ABCDEF",       
  "visitorFound":true,
  "browserDetails":{                    
    "browserName":"Chrome",
    "browserMajorVersion":"119",
    "browserFullVersion":"119.0.0",
    "os":"Mac OS X",                    
    "osVersion":"10.15.7",
    "device":"Other",
    "userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36"
  },
  "incognito":false,                    
  "clientReferrer":"http://localhost:3000/",
  "confidence":{                        
    "score":1
  },
  "firstSeenAt":{
    "global":"2023-11-12T17:26:05.3Z",
    "subscription":"2023-11-12T17:26:05.3Z"
  },
  "lastSeenAt":{
    "global":"2023-12-06T08:55:14.457Z", 
    "subscription":"2023-12-06T08:55:14.457Z"
  },
  "bot":{                                
    "result":"notDetected"
  },
  "userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36",
  "ipInfo":{
    "v4":{
      "address":"46.149.66.130",
      "geolocation":{
        "accuracyRadius":1000,
        "latitude":11.2233,
        "longitude":44.5566,
        "timezone":"Europe/Moscow",
        "country":{
          "code":"RU",
          "name":"Russia"
        },
        "continent":{
          "code":"EU",
          "name":"Europe"
        }
      },
      "asn":{                           
        "asn":"123456",
        "name":"Telecom Ltd",
        "network":"0.0.0.0/16"
      },
      "datacenter":{
        "result":false,
        "name":""
      }
    }
  },
  "vpn":{                              
    "result":false,
    "originTimezone":"Europe/Moscow",
    "methods":{
      "timezoneMismatch":false,
      "publicVPN":false,
      "auxiliaryMobile":false
    }
  },
  "tampering":{                        
    "result":false,
    "anomalyScore":0
  }
  "suspectScore": {
    "result": 0
  }
}

```

<table><thead><tr><th width="320"></th><th></th></tr></thead><tbody><tr><td>requestId</td><td>ID запроса</td></tr><tr><td>url</td><td>URL-адрес, с которого был сделан запрос</td></tr><tr><td>ip</td><td>IP-адрес, с которого был сделан запрос</td></tr><tr><td>time</td><td>Время, в которое был сделан запрос, в формате ISO8601</td></tr><tr><td>timestamp</td><td>Сколько секунд прошло с 1970-01-01 00:00:00</td></tr><tr><td>ipLocation</td><td>Местоположение</td></tr><tr><td>visitorId</td><td>ID пользователя</td></tr><tr><td>visitorFound</td><td>Флаг обнаружения пользователя</td></tr><tr><td>browserDetails</td><td>Информация о браузере</td></tr><tr><td>incognito</td><td>Флаг режима инкогнито</td></tr><tr><td>confidence/score</td><td>Точность идентификации</td></tr><tr><td>firstSeenAt</td><td>Дата первой активности</td></tr><tr><td>lastSeenAt</td><td>Дата последней активности</td></tr><tr><td>bot</td><td>Является ли пользователем - ботом</td></tr><tr><td>userAgent</td><td>userAgent пользователя</td></tr><tr><td>ipInfo</td><td>Информация об IP</td></tr><tr><td>asn</td><td>Информация о провайдере</td></tr><tr><td>vpn</td><td>Информация о VPN</td></tr><tr><td>tampering</td><td>Подделка браузера</td></tr><tr><td>suspectScore</td><td>Оценка подозрительности</td></tr></tbody></table>

## Privacy Settings

PrivecySettings - Браузеры Firefox, Brave, антидетект бразуеры и пр, которые ставят акцент на конфиденциальность, активно работают над тем, чтобы предотвратить снятие отпечатков браузера и раскрывают настройки пользователя, способные случайным образом менять и усложнять сигналы. Эти настройки, связанные с конфиденциальностью, определяются и сообщается о них.

## Datacenter

datacenter - Посетитель подключается через промежуточный сервер, а не напрямую через интернет провайдера.

## Suspect Score

"Suspect Score" или  Оценка Подозрительности - это единичное значение, представляющее, сколько маркеров, указывающих на подозрительную или мошенническую активность, было запущено для определенного идентификатора запроса "`requestId`". Каждый маркер представлен положительным целым числом, называемым весом. Веса являются аддитивными, что означает, что чем больше маркеров возвращают положительное значение, тем выше итоговый балл.

### Вес Оценки Подозрительности

Каждый маркер имеет свой собственный вес, влияющий на итоговую оценку. Веса в настоящее время основаны на вероятности срабатывания выбранного маркера в глобальном масштабе. Маркеры, вероятность срабатывания которых меньше, имеют более высокие веса, и наоборот.

Значения весов могут немного отличаться в зависимости от платформы, на которой выполняется запрос (Web, Android и iOS). Это вызвано различным представлением среднего трафика для каждой платформы.

|                                                               |             |         |     |
| ------------------------------------------------------------- | :---------: | :-----: | :-: |
| Smart Signal                                                  | Web/браузер | Android | iOS |
| Обнаружение бота (Bad Bot)                                    |      7      |    -    |  -  |
| Обнаружение инкогнито                                         |      4      |    -    |  -  |
| VPN - Несоответствие часовых поясов                           |      3      |    4    |  4  |
| VPN - Общедоступный VPN-сервис                                |      4      |    5    |  5  |
| VPN - Обнаружение мобильных устройств                         |      -      |    6    |  6  |
| Обнаружение несанкционированного доступа                      |      8      |    -    |  -  |
| Обнаружение виртуальной машины                                |      14     |    -    |  -  |
| Настройки конфиденциальности                                  |      6      |    -    |  -  |
| Список заблокированных IP-адресов - Спам по электронной почте |      14     |    12   |  13 |
| Список заблокированных IP-адресов - Известный источник атаки  |      14     |    13   |  13 |
| Узел выхода из Tor                                            |      13     |    16   |  17 |
| Публичный прокси-сервер                                       |      14     |    12   |  15 |
| Обнаружение эмулятора Android                                 |      14     |    9    |  -  |
| Обнаружение взлома Android                                    |      -      |    12   |  -  |
| Обнаружение клонов приложений                                 |      -      |    9    |  -  |
| Обнаружение джейлбрейка                                       |      -      |    -    |  10 |
| Обнаружение Frida                                             |      -      |    14   |  -  |
| Высокоактивное устройство                                     |      6      |    5    |  6  |