Перейти к основному содержимому

Создание профиля браузера

Описание: Этот метод создает новый профиль браузера в указанном рабочем пространстве и папке.
Можно настраивать разные параметры, такие как размер экрана, эмуляция железа, язык, часовой пояс, прокси и т.д.
Все параметры являются необязательными, если отдельно не указано иное.

Параметры запроса:

ПараметрТипФорматПо умолчаниюОписание
namestringИмя профиля.
workspaceIdintegerint64-1Идентификатор рабочего пространства. -1 — рабочее пространство по умолчанию.
folderIdstringuuid(пусто)Идентификатор папки (опционально).
screenstring(пусто)Настройки экрана. Возможные значения: “auto” — использовать значение из фингерпринта, “ignore” — использовать системное значение или “width x height” — задать собственное разрешение экрана (auto, ignore или width x height).
cpustring(пусто)Настройки CPU. Возможные значения: “auto” — использовать значение из фингерпринта, “ignore” — использовать системное значение или целое число — задать количество ядер процессора (auto, ignore или число ядер).
memorystring(пусто)Настройки памяти. Возможные значения: “auto” — использовать значение из фингерпринта, “ignore” — использовать системное значение или целое число — задать размер памяти в мегабайтах (auto, ignorate или размер памяти в MB).
languagestring(пусто)Настройки языка браузера. Возможные значения: “auto” — использовать значение из фингерпринта, “ignore” — использовать системное значение или значение языковой локали (auto, ignorate или локаль: Russian - ru English (United States) - en-US German - de French - fr Spanish - es English (United Kingdom) - en-GB).
geoLocationstring(пусто)Настройки геолокации. Возможные значения: “auto” — использовать значение из фингерпринта, “ignore” — использовать системное значение. Также можно указать от одного до семи чисел с плавающей точкой, которые задают следующие гео-координаты: Latitude, Longitude, Altitude, Accuracy, AltitudeAccuracy, Heading, Speed, Radius. Некоторые координаты можно пропускать. Например, следующая последовательность допустима: 10, , 40, , 60, 70 — означает Latitude = 10, Longitude = случайное значение, Altitude = 40, Accuracy = случайное значение, AltitudeAccuracy = 60, Heading = 70, Speed = случайное значение, Radius = случайное значение (auto, ignore или координаты (latitude, longitude и т. д.)).
timeZonestring(пусто)Настройки часового пояса. Возможные значения: “auto” — использовать значение из фингерпринта, “ignore” — использовать системное значение или указать конкретный часовой пояс (auto, ignore или конкретное значение, например Europe/Moscow).
webGlstring(пусто)Настройки WebGL. Возможные значения: “auto” — использовать значение из фингерпринта, “ignore” — использовать системное значение (auto или ignore).
webGpustring(пусто)Настройки WebGPU. Возможные значения: “on” — включить или “off” — выключить эту функцию (on или off).
webRtcstring(пусто)Настройки WebRTC. Возможные значения: “Emulate” — использовать значение из фингерпринта, “Real” — использовать системное значение или “Hide” — отключить эту функцию (Emulate, Real или Hide).
domRectstring(пусто)Настройки DOM Rectangle. Возможные значения: “Ignore” — отключить данный функционал или “Noise” — включить зашумление dom rect (Ignore или Noise).
audiostring(пусто)Настройки аудио. Возможные значения: “on” — включить или “off” — отключить эту функцию (on или off).
fontsstring(пусто)Настройки шрифтов. Возможные значения: “on” — включить или “off” — отключить эту функцию (on или off).
batterystring(пусто)Настройки батареи. Возможные значения: “on” — включить или “off” — отключить эту функцию (on или off).
pluginsstring(пусто)Настройки плагинов браузера. Возможные значения: “on” — включить или “off” — отключить эту функцию (on или off).
proxyServerIdstringuuid(пусто)Идентификатор прокси-сервера (опционально).
speechVoicesstring(пусто)Настройки голосов озвучки. Возможные значения: “on” — включить или “off” — отключить эту функцию (on или off).
cookiesstring(пусто)Настройки cookies.
notesstring(пусто)Дополнительные заметки к профилю.
tagsstring(пусто)Теги профиля, разделенные пробелами (например, 1 2 3 4).

Пример запроса:

POST
CURL:

curl 'http://localhost:8160/v1/profiles/create?name=&workspaceId=-1&folderId=&screen=&cpu=&memory=&language=&geoLocation=&timeZone=&webGl=&webGpu=&webRtc=&domRect=&audio=&fonts=&battery=&plugins=&proxyServerId=&speechVoices=&cookies=&notes=&tags=' \
--request POST \
--header 'Api-Token: YOUR_SECRET_TOKEN'

C#:

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
Method = HttpMethod.Post,
RequestUri = new Uri("http://localhost:8160/v1/profiles/create?name=&workspaceId=-1&folderId=&screen=&cpu=&memory=&language=&geoLocation=&timeZone=&webGl=&webGpu=&webRtc=&domRect=&audio=&fonts=&battery=&plugins=&proxyServerId=&speechVoices=&cookies=&notes=&tags="),
Headers =
{
{ "Api-Token", "YOUR_SECRET_TOKEN" },
},
};
using (var response = await client.SendAsync(request))
{
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}

Cube:

http://localhost:8160/v1/profiles/create?name=&workspaceId=-1&folderId=&screen=&cpu=&memory=&language=&geoLocation=&timeZone=&webGl=&webGpu=&webRtc=&domRect=&audio=&fonts=&battery=&plugins=&proxyServerId=&speechVoices=&cookies=&notes=&tags=

Дополнительно:
User-Agent: {-Profile.UserAgent-}
Api-Token: токен из UserArea2

Ответ API:

Код ответаРезультат
200 OKУспешно
500 ErrorВнутренняя ошибка сервера

Успешный ответ (200 OK):

Возвращает ID вновь созданного профиля:

123e4567-e89b-12d3-a456-426614174000

Ответ с ошибкой (500):

{
"message": null
}