Швидке створення профілю браузера

Довідник API

Швидке створення профілю браузера

Request

Створює від 1 до 200 профілів браузера зі спільною конфігурацією.

Передумови: у тарифі команди має залишитися достатньо профілів, а добова квота створення не має бути витрачена. isEncrypt=1 вимагає, щоб у команди був налаштований ключ шифрування. Firefox доступний лише на Windows та macOS. groupId уже має існувати, але якщо замість нього передати groupName, групу буде створено автоматично.
Ефект: вставляє профілі, витрачає ємність тарифу та збільшує добовий лічильник створення. Передавання даних підключення проксі також може створити запис проксі.
Завершення: синхронне. data містить ID нових профілів у порядку створення.
Повтор: не ідемпотентний, ключа ідемпотентності немає. Замість повтору підтвердьте результат через /env/page.
Local API: ядра-кандидати фільтруються за версією запущеного клієнта для робочого столу, а одночасні виклики від однієї команди серіалізуються блокуванням на рівні команди.

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

Bodyapplication/json

browserTypeIdintegerrequired

1: Chrome, 2: Firefox

Example:1

groupIdstring

Ідентифікатор групи середовища; за замовчуванням: негрупований (0)

Example:"0"

groupNamestring, <= 50 characters

Назва групи (макс. 50 символів). Якщо вказано, система спочатку перевіряє groupId: якщо знайдено дійсну групу, вона використовується; інакше виконується пошук за groupName. Якщо група з такою назвою існує, вона використовується; якщо ні — створюється нова. Кожна команда обмежена 1 000 групами.

Example:""

isEncryptinteger

Увімкнути наскрізне шифрування? 0: Ні, 1: Так; за замовчуванням: 0

operatorSystemIdintegerrequired

Тип ОС 1: Windows, 2: macOS, 3: Android, 4: iOS

Example:1

quantityinteger, [ 1 .. 50 ]required

Кількість середовищ для створення; діапазон: [1–50]

Example:1

browserCoreinteger

Версія ядра браузера; за замовчуванням: 0 (автоматичне збігання). Отримайте доступні версії через '/api/env/advanced/ua/versions'

Example:140

proxyobject

Проксі

curl -i -X POST \
  http://127.0.0.1:40000/api/env/create/quick \
  -H 'Content-Type: application/json' \
  -d '{
    "browserTypeId": 1,
    "operatorSystemId": 1,
    "quantity": 1
  }'

Responses

Успіх. data — масив значень string; порожній масив, якщо повертати нічого.

Headers

any

Bodyapplication/json

codeintegerrequired

msgstring or nullrequired

dataArray of stringsrequired

requestIdstringrequired

Response

{
  "code": 0,
  "msg": null,
  "data": [
    "string"
  ],
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d"
}