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

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

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

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

ParameterTypeFormatDefaultDescription
workspaceIdintegerint64-1Идентификатор рабочего пространства. -1 означает рабочее пространство по умолчанию.
desktopNamestring(empty)Имя рабочего стола (необязательно).
keepAliveлогическое значениеtrueПоказывает, должны ли экземпляры браузера оставаться активными после создания. Установите true, чтобы экземпляры оставались активными; в противном случае false. Значение по умолчанию — true (true или false).
environmentTagsstring(empty)Теги для конфигурации окружения экземпляра браузера.
commandLineArgumentsstring(empty)Пользовательские дополнительные аргументы командной строки, которые будут переданы браузеру при запуске.
bodyJSON-ArrayМассив UUID профилей, для которых нужно создать экземпляры браузера. Пример: ["uuid1", "uuid2"]

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

POST
CURL:

curl 'http://localhost:8160/v1/browser_instances/create_bulk?workspaceId=-1&desktopName=Desktop%201&keepAlive=true&environmentTags=&commandLineArguments=--disable-gpu' \
--request POST \
--header 'Content-Type: application/json' \
--header 'Api-Token: YOUR_SECRET_TOKEN' \
--data '[
"123e4567-e89b-12d3-a456-426614174000"
]'

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_bulk?workspaceId=-1&desktopName=Desktop%201&keepAlive=true&environmentTags=&commandLineArguments=--disable-gpu"),
Headers =
{
{ "Api-Token", "YOUR_SECRET_TOKEN" },
},
Content = new StringContent("[\n \"123e4567-e89b-12d3-a456-426614174000\"\n]")
{
Headers =
{
ContentType = new MediaTypeHeaderValue("application/json")
}
}
};
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_bulk?workspaceId=-1&desktopName=Desktop 1&keepAlive=true&environmentTags=&commandLineArguments=--disable-gpu

Body (JSON):

[
"123e4567-e89b-12d3-a456-426614174000"
]

Дополнительно:
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": "ws://127.0.0.1:12345/devtools/browser/example"
}
]

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

{
"message": null
}