April 16, 2020

AEZAKMI API

API для партнеров и пользователей с лицензией GroveStreet

Для интеграции в ПО и автоматизации работы с браузерными отпечатками AEZAKMI,
в нашем сервисе предусмотрены вызовы API возвращающие ответы в формате JSON

Все API вызовы настроены на прием POST запроса с данными в JSON формате.

Для проверки вашей лицензии - в заголовке "authorization" каждого POST запроса на API Aezakmi требуется указывать ваш аутентификационный ключ

//Headers
authorization: "ApiKey" 
Пример: authorization: eyJsb2dpbgiI6Im04bmc4dbCIsInBhc3N3b3JkIjoiOC96UTJEd3RSaf2VpOHJaOHdEOWZRdQXY2W45mxwR09TLzJ5TGN3dEx1a0FvVT0ifQ==

API Key можно получить, открыв выпадающее окно по кнопке расширения. Необходимо нажать право клавишей на рабочую область расширения и выбрать "Просмотреть код" После чего - в появившемся окне необходимо перейти на вкладку "Console", И ввести там

localStorage.getItem("datetime")


Полученное значение и есть Api Key

Методы API

Создание профиля отпечатка.

POST https://account.aezakmi.run/api/create_fast_profile

authorization: APIKEY
Content-Type: application/json

POST DATA (JSON)

browser: Позволяет указать желаемый браузер в отпечатке. Chrome или Firefox. Полный список доступных браузеров вы всегда можете посмотреть в личном кабинете при создании профиля.
os: Позволяет указать желаемую операционную систему в отпечатке. Windows, Mac OS или Firefox. Полный список доступных операционных систем вы всегда можете посмотреть в личном кабинете при создании профиля.
width: желаемая ширина разрешения экрана
height: желаемая высота расширения экрана
Важно - значения высоты и ширины экрана не должны превышать ваше реальное разрешение экрана. Так же очень важно выбирать распространенные разрешения, например "width": 1920 и "height": 1080 - для FullHD мониторов. Реальные комбинации разрешений экранов вы можете посмотреть в личном кабинете при создании профиля.
profileName: Желаемое имя профиля.
login: Ваш логин в Aezakmi
timestamp: текущее время создания профиля в милисекундах c 1 января 1970 года. Стандартное обозначение времени во всех языках програмирования и операционных системах.
В Linux можно получить с помощью команды date '+%s'. В JavaScript - new Date(). Можете всегда обратиться в наш саппорт - мы подскажем как получить это значение.
Эти значения нужно заполнять только если хотите использовать прокси в отпечатке. В ином случае их можно оставить пустыми.
proxyProtocol: Протокол вашего прокси http \ https \ socks4 \ socks5
proxyIp: ip адрес или домен вашего прокси
proxyPort: порт вашего прокси
Не на всех прокси есть логин и пароль. В таком случае эти значения можно оставить пустыми.
proxyLogin: логин вашего прокси
proxyPassword: пароль вашего прокси
cookies: Позволяет загрузить в ваш профиль куки в json формате. Можно оставить пустой строкой.
canvasNoise: Позволяет указать нужно ли зашумлять работу canvas рендеринга для получения уникального значения в отпечатке. Допустимые значения: 1 - зашумлять. 0 - не зашумлять
webglNoise: Позволяет указать нужно ли зашумлять работу webgl рендеринга для получения уникального значения в отпечатке. Допустимые значения: 1 - зашумлять. 0 - не зашумлять
audioNoise: Позволяет указать нужно ли зашумлять работу аудиобуфера для получения уникального значения в отпечатке. Допустимые значения: 1 - зашумлять. 0 - не зашумлять
doNotTrack: Позволяет указывать значение опции DoNotTrack на посещаемых сайтах. 0 - выключена. 1 - включена.
webrtcDisable: Позволяет указать нужно ли блокировать WebRTC для предотвращения утечки ip. 0 - выключен. 1 - включен

Пример:

{
    "browser": "Chrome",
    "os": "Windows",
    "width": 1920,
    "height": 1080,
    "profileName": "APITEST6667",
    "login": "admin",
    "timestamp": 1580587959927,
    "proxyProtocol": "",
    "proxyIp": "",
    "proxyPort": "",
    "proxyLogin": "",
    "proxyPassword": "",
    "cookies": [{"value":"5%3AbPQ63RuVH2URRw%3A2%3A1578178208%3A-1%3A-1","domain":".facebook.com","hostOnly":false,"sameSite":"no_restriction","storeId":"0","session":true,"expirationDate":1639341544,"secure":true,"httpOnly":true,"path":"/","name":"xs"},{"value":"y","domain":".facebook.com","hostOnly":false,"sameSite":"no_restriction","storeId":"0","session":true,"expirationDate":1639341544,"secure":true,"httpOnly":true,"path":"/","name":"pl"},{"value":"1366x695","domain":".facebook.com","hostOnly":false,"sameSite":"no_restriction","storeId":"0","session":true,"expirationDate":1639341544,"secure":true,"httpOnly":false,"path":"/","name":"wd"},{"value":"7cxFOaJ8kmyCj5MX8.AWWfChC1cPPHresarSy4FnUOB54.BeERWD.vD.AAA.0.0.BeERab.AWV6W519","domain":".facebook.com","hostOnly":false,"sameSite":"no_restriction","storeId":"0","session":true,"expirationDate":1639341544,"secure":true,"httpOnly":true,"path":"/","name":"fr"},{"value":"gxURXpFFE9xtMSUL4ReWgaQu","domain":".facebook.com","httpOnly":true,"secure":true,"hostOnly":false,"sameSite":"no_restriction","storeId":"0","session":true,"expirationDate":1639341544,"path":"/","name":"datr"},{"value":"mxYRXu9uP5ehjHVxLa6_PpBr","domain":".facebook.com","httpOnly":true,"secure":true,"hostOnly":false,"sameSite":"no_restriction","storeId":"0","session":true,"expirationDate":1639341544,"path":"/","name":"sb"},{"value":"100045761071769","domain":".facebook.com","httpOnly":false,"secure":true,"hostOnly":false,"sameSite":"no_restriction","storeId":"0","session":true,"expirationDate":1639341544,"path":"/","name":"c_user"}],
    "canvasNoise": 1,
    "webglNoise": 1,
    "audioNoise": 1,
    "doNotTrack": 0,
    "webrtcDisable": 1,
    "enable911": 0
}

Удаление профиля отпечатка

POST https://account.aezakmi.run/api/delete_current_user_profile

authorization: APIKEY
Content-Type: application/json

POST DATA (JSON)

profileName: Имя профиля для удаления
login: Ваш логин в Aezakmi

Пример:

{
    "profileName": "APITEST6667",
    "login": "admin"
}