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

Создание экземпляра браузера

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

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

ParameterTypeFormatDefaultDescription
profileIdstringuuid(required)Уникальный идентификатор профиля, с которым будет связан экземпляр браузера.
workspaceIdintegerint64-1Идентификатор рабочего пространства. -1 означает рабочее пространство по умолчанию.
desktopNamestring(empty)Имя среды рабочего стола (необязательно).
threadTokenstring(empty)Токен потока для экземпляра браузера. Чтобы создать новый поток выполнения (необязательно), передайте пустую строку (значение по умолчанию).
environmentTagsstring(empty)Теги для конфигурации окружения экземпляра браузера.
commandLineArgumentsstring(empty)Пользовательские дополнительные аргументы командной строки, которые будут переданы браузеру при запуске.

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

POST
CURL:

curl 'http://localhost:8160/v1/browser_instances/create?profileId=123e4567-e89b-12d3-a456-426614174000&workspaceId=-1&desktopName=Desktop%201&threadToken=thread-token-1&environmentTags=&commandLineArguments=--disable-gpu' \
--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/browser_instances/create?profileId=123e4567-e89b-12d3-a456-426614174000&workspaceId=-1&desktopName=Desktop%201&threadToken=thread-token-1&environmentTags=&commandLineArguments=--disable-gpu"),
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/browser_instances/create?profileId=PROFILE_ID&workspaceId=-1&desktopName=Desktop 1&threadToken=thread-token-1&environmentTags=&commandLineArguments=--disable-gpu

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

Ответ API:

Код ответаРезультат
200 OKУспешно
401 UnauthorizedНе авторизован
403 ForbiddenДоступ запрещен
500 Internal Server ErrorВнутренняя ошибка сервера

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

{
"profileId": "123e4567-e89b-12d3-a456-426614174000",
"processId": 1,
"connectionString": null
}

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

{
"message": null
}