Перейти до вмісту

Оновити відбиток пальця

Request

Перегенеровує відбиток профілю браузера.

  • Передумови: укажіть профіль через envId або uniqueId. Зашифровані профілі відхиляються. Запущений профіль не блокується, але новий відбиток застосовується з наступного запуску.
  • Ефект: генерує новий відбиток, випадковим чином задає ім'я хоста та MAC-адресу й заново підбирає ядро браузера. Значення, явно вказані в запиті, мають пріоритет над згенерованими.
  • Завершення: синхронне.
  • Повтор: ніколи не повторюйте автоматично. Кожен виклик дає інший випадковий відбиток, тому наосліп повторений запит після таймауту змінить профіль удруге. Спершу порівняйте через /env/detail.

Задокументовані бізнес-помилки: 19039, 19104, 19105, 19106, 19107, 19108, 19111, 19142, 19193. Значення кодів див. у Error Codes. Будь-яка операція може додатково повернути загальні коди.

Bodyapplication/jsonrequired
envIdstringrequired

Ідентифікатор профілю (ідентифікатор середовища). Потрібно вказати лише один із варіантів: envId або uniqueId.

uniqueIdstring

Серійний номер профілю (унікальний ідентифікатор). Потрібно вказати лише один із варіантів: envId або uniqueId.

uaVersioninteger

Версія цільового User-Agent (наприклад, Chrome 129).

Якщо пропущено, використовується поточна версія UA з профілю.

Example:129
browserTypeIdinteger

Тип браузера. 1 = Chrome, 2 = Firefox.

Enum:12
operatorSystemIdinteger

Тип операційної системи. 1 = Windows, 2 = macOS, 3 = Android, 4 = iOS.

Enum:1234
advancedSettingobject(AdvancedSetting)

Розширене налаштування відбитків пальців та поведінки браузера.

curl -i -X POST \
  http://127.0.0.1:40000/api/env/fingerprint/refresh \
  -H 'Content-Type: application/json' \
  -d '{
    "envId": "1869988538611834880",
    "uniqueId": "",
    "uaVersion": 129,
    "browserTypeId": 1,
    "operatorSystemId": 2,
    "advancedSetting": {}
  }'

Responses

Успіх. data для цієї операції завжди null; результат передається через code.

Headers
any
Bodyapplication/json
codeinteger
msgstring or null
datanull
requestIdstring
Response
{ "code": 0, "msg": null, "data": null, "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d" }