APIAPI и интеграцииAPI ShardX LauncherModels

Models

ErrorobjectShow propertiesHide properties
errorstringrequired
FingerprintEnvelopeobjectShow propertiesHide properties
fingerprintobject · Fingerprintrequired

Нативный FingerprintConfig. Документированные подобъекты; наиболее распространённые; объект открытый и сохраняется эндпоинтами создания дословно, так что любое поле здесь будет передано без изменений.

Show propertiesHide properties
namestringoptional
notesstringoptional
seedintegeroptional

0 = режим только переопределений (типичный случай).

navigatorobjectoptional
Show propertiesHide properties
user_agentstringoptional
platformstringoptional
hardware_concurrencyintegeroptional
device_memoryinteger · enumoptional
Possible values:81632
languagestringoptional
do_not_trackbooleanoptional
screenobjectoptional
Show propertiesHide properties
widthintegeroptional
heightintegeroptional
avail_widthintegeroptional
avail_heightintegeroptional
color_depthintegeroptional
device_pixel_rationumberoptional
color_gamutstring · enumoptional
Possible values:srgbp3rec2020
refresh_rateinteger· min: 24· max: 480optional

Частота обновления заявленного экрана. Если поле не указано, используется значение 60. См. поле refresh_rate в запросах создания и редактирования.

client_hintsobjectoptional

Семейство Sec-CH-UA (в browser.vision называется hints).

Show propertiesHide properties
platformstringoptional
platform_versionstringoptional
architecturestringoptional
bitnessstringoptional
mobilebooleanoptional
webglobjectoptional
Show propertiesHide properties
unmasked_vendorstringoptional
unmasked_rendererstringoptional
webgpuobjectoptional
webrtcstring · enumoptional

Режим обработки WebRTC.

Possible values:autotcp_onlyblock
noiseobject · NoisePrefsoptional

Настройки антифингерпринт-шума по векторам. Каждый блок: {enabled, seed} (+ специфичные параметры). enabled:false = сквозная передача.

Show propertiesHide properties
canvasobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

webglobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

intensitynumberoptional
audioobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

intensitynumberoptional
client_rectsobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

max_offsetnumberoptional
sensorsobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

fontsobject · NoiseBlockoptional

enabled:true скрывает небольшое детерминированное подмножество несущественных шрифтов для каждого профиля (остальные реальные шрифты хоста проходят насквозь).

Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

networkobjectoptional
Show propertiesHide properties
blocked_portsinteger[]optional

Защита от сканирования портов локальной сети (ports_protection).

timezonestringoptional

Имя по IANA или "auto"; будет определено через привязанный прокси при запуске.

Fingerprintobject

Нативный FingerprintConfig. Документированные подобъекты; наиболее распространённые; объект открытый и сохраняется эндпоинтами создания дословно, так что любое поле здесь будет передано без изменений.

Show propertiesHide properties
namestringoptional
notesstringoptional
seedintegeroptional

0 = режим только переопределений (типичный случай).

navigatorobjectoptional
Show propertiesHide properties
user_agentstringoptional
platformstringoptional
hardware_concurrencyintegeroptional
device_memoryinteger · enumoptional
Possible values:81632
languagestringoptional
do_not_trackbooleanoptional
screenobjectoptional
Show propertiesHide properties
widthintegeroptional
heightintegeroptional
avail_widthintegeroptional
avail_heightintegeroptional
color_depthintegeroptional
device_pixel_rationumberoptional
color_gamutstring · enumoptional
Possible values:srgbp3rec2020
refresh_rateinteger· min: 24· max: 480optional

Частота обновления заявленного экрана. Если поле не указано, используется значение 60. См. поле refresh_rate в запросах создания и редактирования.

client_hintsobjectoptional

Семейство Sec-CH-UA (в browser.vision называется hints).

Show propertiesHide properties
platformstringoptional
platform_versionstringoptional
architecturestringoptional
bitnessstringoptional
mobilebooleanoptional
webglobjectoptional
Show propertiesHide properties
unmasked_vendorstringoptional
unmasked_rendererstringoptional
webgpuobjectoptional
webrtcstring · enumoptional

Режим обработки WebRTC.

Possible values:autotcp_onlyblock
noiseobject · NoisePrefsoptional

Настройки антифингерпринт-шума по векторам. Каждый блок: {enabled, seed} (+ специфичные параметры). enabled:false = сквозная передача.

Show propertiesHide properties
canvasobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

webglobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

intensitynumberoptional
audioobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

intensitynumberoptional
client_rectsobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

max_offsetnumberoptional
sensorsobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

fontsobject · NoiseBlockoptional

enabled:true скрывает небольшое детерминированное подмножество несущественных шрифтов для каждого профиля (остальные реальные шрифты хоста проходят насквозь).

Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

networkobjectoptional
Show propertiesHide properties
blocked_portsinteger[]optional

Защита от сканирования портов локальной сети (ports_protection).

timezonestringoptional

Имя по IANA или "auto"; будет определено через привязанный прокси при запуске.

NoisePrefsobject

Настройки антифингерпринт-шума по векторам. Каждый блок: {enabled, seed} (+ специфичные параметры). enabled:false = сквозная передача.

Show propertiesHide properties
canvasobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

webglobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

intensitynumberoptional
audioobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

intensitynumberoptional
client_rectsobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

max_offsetnumberoptional
sensorsobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

fontsobject · NoiseBlockoptional

enabled:true скрывает небольшое детерминированное подмножество несущественных шрифтов для каждого профиля (остальные реальные шрифты хоста проходят насквозь).

Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

NoiseBlockobjectShow propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

CreateProfileRequestobjectShow propertiesHide properties
namestringoptional
notesstringoptional
proxy_idstringoptional

Привязать прокси из хранилища (по id).

proxystringoptional

Привязать прокси строкой (host:port:user:pass или scheme://user:pass@host:port). Для постоянного профиля прокси добавляется в хранилище (дедупликация по эндпоинту) и проходит полный тест (UDP + гео), затем привязывается по id; отображается в списке прокси, результат QUIC/WebRTC кешируется. Для временного профиля прокси прикрепляется инлайн (не сохраняется). Игнорируется, если задан proxy_id.

folderstringoptional

Тег папки (игнорируется для /folders/{folder}/profiles; там приоритет у пути).

colorstringoptional

Акцентный цвет значка окна профиля и метки с его названием в адресной строке. Если поле не указано, цвет значка определяется по имени, а метка сохраняет цвет панели инструментов браузера.

extensionsstring[]optional

Идентификаторы расширений из библиотеки (GET /extensions), загружаемых при запуске. Если идентификатор отсутствует в библиотеке, возвращается ошибка 400. Профиль без такого расширения не запускается автоматически.

refresh_rateinteger· min: 24· max: 480optional

Заявленная частота обновления дисплея, записанная в screen.refresh_rate. Ни один веб-API не сообщает об этом; страница измеряет его по времени requestAnimationFrame, поэтому его исключение не является нейтральным; «Отсутствие» означает 60, о чем сообщает большинство машин, а не о том, что делает собственный экран хоста. Кадры можно только замедлять, поэтому эффективная скорость равна ближайшему целому разделению панели хоста на этом или меньшем уровне.

fingerprintobject · Fingerprintrequired

Сохраняется дословно. Получите из /fingerprint/new и при необходимости отредактируйте.

Show propertiesHide properties
namestringoptional
notesstringoptional
seedintegeroptional

0 = режим только переопределений (типичный случай).

navigatorobjectoptional
Show propertiesHide properties
user_agentstringoptional
platformstringoptional
hardware_concurrencyintegeroptional
device_memoryinteger · enumoptional
Possible values:81632
languagestringoptional
do_not_trackbooleanoptional
screenobjectoptional
Show propertiesHide properties
widthintegeroptional
heightintegeroptional
avail_widthintegeroptional
avail_heightintegeroptional
color_depthintegeroptional
device_pixel_rationumberoptional
color_gamutstring · enumoptional
Possible values:srgbp3rec2020
refresh_rateinteger· min: 24· max: 480optional

Частота обновления заявленного экрана. Если поле не указано, используется значение 60. См. поле refresh_rate в запросах создания и редактирования.

client_hintsobjectoptional

Семейство Sec-CH-UA (в browser.vision называется hints).

Show propertiesHide properties
platformstringoptional
platform_versionstringoptional
architecturestringoptional
bitnessstringoptional
mobilebooleanoptional
webglobjectoptional
Show propertiesHide properties
unmasked_vendorstringoptional
unmasked_rendererstringoptional
webgpuobjectoptional
webrtcstring · enumoptional

Режим обработки WebRTC.

Possible values:autotcp_onlyblock
noiseobject · NoisePrefsoptional

Настройки антифингерпринт-шума по векторам. Каждый блок: {enabled, seed} (+ специфичные параметры). enabled:false = сквозная передача.

Show propertiesHide properties
canvasobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

webglobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

intensitynumberoptional
audioobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

intensitynumberoptional
client_rectsobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

max_offsetnumberoptional
sensorsobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

fontsobject · NoiseBlockoptional

enabled:true скрывает небольшое детерминированное подмножество несущественных шрифтов для каждого профиля (остальные реальные шрифты хоста проходят насквозь).

Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

networkobjectoptional
Show propertiesHide properties
blocked_portsinteger[]optional

Защита от сканирования портов локальной сети (ports_protection).

timezonestringoptional

Имя по IANA или "auto"; будет определено через привязанный прокси при запуске.

EditProfileRequestobject

Все поля необязательны; изменяется только переданное.

Show propertiesHide properties
namestringoptional
notesstringoptional
folderstringoptional

"" убирает профиль из папки (переводит в «Все»).

proxy_idstringoptional

"" отвязывает прокси.

proxystringoptional

Строка прокси; сохраняется (дедупликация) + полный тест, затем привязывается.

colorstringoptional

#rrggbb; пустая строка возвращает цвет, вычисленный по названию.

extensionsstring[]optional

Заменяет весь список; [] ничего не загружает.

refresh_rateinteger· min: 24· max: 480optional

Заявленная частота обновления дисплея применяется ПОСЛЕ fingerprint и записывается в screen.refresh_rate. Ни один веб-API не сообщает об этом; страница измеряет его по времени requestAnimationFrame, поэтому его исключение не является нейтральным; «Отсутствие» означает 60, о чем сообщает большинство машин, а не о том, что делает собственный экран хоста. Кадры можно только замедлять, поэтому эффективная скорость равна ближайшему целому разделению панели хоста на этом или меньшем уровне.

fingerprintobject · Fingerprintoptional

При наличии ЗАМЕНЯЕТ сохранённый отпечаток дословно.

Show propertiesHide properties
namestringoptional
notesstringoptional
seedintegeroptional

0 = режим только переопределений (типичный случай).

navigatorobjectoptional
Show propertiesHide properties
user_agentstringoptional
platformstringoptional
hardware_concurrencyintegeroptional
device_memoryinteger · enumoptional
Possible values:81632
languagestringoptional
do_not_trackbooleanoptional
screenobjectoptional
Show propertiesHide properties
widthintegeroptional
heightintegeroptional
avail_widthintegeroptional
avail_heightintegeroptional
color_depthintegeroptional
device_pixel_rationumberoptional
color_gamutstring · enumoptional
Possible values:srgbp3rec2020
refresh_rateinteger· min: 24· max: 480optional

Частота обновления заявленного экрана. Если поле не указано, используется значение 60. См. поле refresh_rate в запросах создания и редактирования.

client_hintsobjectoptional

Семейство Sec-CH-UA (в browser.vision называется hints).

Show propertiesHide properties
platformstringoptional
platform_versionstringoptional
architecturestringoptional
bitnessstringoptional
mobilebooleanoptional
webglobjectoptional
Show propertiesHide properties
unmasked_vendorstringoptional
unmasked_rendererstringoptional
webgpuobjectoptional
webrtcstring · enumoptional

Режим обработки WebRTC.

Possible values:autotcp_onlyblock
noiseobject · NoisePrefsoptional

Настройки антифингерпринт-шума по векторам. Каждый блок: {enabled, seed} (+ специфичные параметры). enabled:false = сквозная передача.

Show propertiesHide properties
canvasobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

webglobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

intensitynumberoptional
audioobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

intensitynumberoptional
client_rectsobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

max_offsetnumberoptional
sensorsobject · NoiseBlockoptional
Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

fontsobject · NoiseBlockoptional

enabled:true скрывает небольшое детерминированное подмножество несущественных шрифтов для каждого профиля (остальные реальные шрифты хоста проходят насквозь).

Show propertiesHide properties
enabledbooleanoptional
seedintegeroptional

Энтропия на профиль; 0 = вычислить автоматически.

networkobjectoptional
Show propertiesHide properties
blocked_portsinteger[]optional

Защита от сканирования портов локальной сети (ports_protection).

timezonestringoptional

Имя по IANA или "auto"; будет определено через привязанный прокси при запуске.

TempProfileRequestobjectShow propertiesHide properties
fingerprint_idstringoptional

Запись библиотеки, на которой основывается профиль; при отсутствии; случайный под platform.

platformstring · enumoptional

Используется для выбора случайного отпечатка, если fingerprint_id не указан; при отсутствии обоих; ОС хоста.

Possible values:WindowsmacOSLinux
proxystringoptional

Инлайн-строка прокси (не сохраняется в хранилище).

namestringoptional
folderstringoptional
refresh_rateinteger· min: 24· max: 480optional

Заявленная частота обновления дисплея, записанная в screen.refresh_rate. Ни один веб-API не сообщает об этом; страница измеряет его по времени requestAnimationFrame, поэтому его исключение не является нейтральным; «Отсутствие» означает 60, о чем сообщает большинство машин, а не о том, что делает собственный экран хоста. Кадры можно только замедлять, поэтому эффективная скорость равна ближайшему целому разделению панели хоста на этом или меньшем уровне.

noiseobjectoptional

Шум отпечатка для каждого вектора. Пропущенные векторы сохраняют значения по умолчанию (отключены). Можно комбинировать два формата: сокращение {"canvas": true, "webgl": true}, которое также применяет интенсивность пользовательского интерфейса по умолчанию к webgl и client_rects, и полный объект, такой как {"canvas": {"enabled": true, "seed": 42}}, соответствующий формату, возвращаемому GET /profiles/{id}.

Поля объединяются с существующими настройками векторов. Если seed не указан или равен нулю, стабильное значение создается на основе идентификатора профиля.

Show propertiesHide properties
canvasanyoptional
webglanyoptional
audioanyoptional
client_rectsanyoptional
sensorsanyoptional
fontsanyoptional
ExtensionobjectShow propertiesHide properties
idstringoptional

Передайте это в extensions профиля.

namestringoptional
versionstringoptional
descriptionstringoptional
size_bytesinteger · int64optional
added_atstringoptional

@<unix_secs>.

iconstring· nullableoptional

Самый большой значок, объявленный в манифесте, как URL-адрес data:. Значение null для конечной точки листинга и для расширений, которые не поставляются.

AddExtensionRequestobject

Ровно один из url или path.

Show propertiesHide properties
urlstringoptional

Страница Интернет-магазина Chrome, простой 32-значный идентификатор расширения или прямая ссылка на .crx/.zip.

pathstringoptional

Локальная .crx, .zip или распакованная папка на компьютере лаунчера.

BookmarkobjectShow propertiesHide properties
idstring · uuidoptional
titlestringoptional
urlstringoptional
folderstringoptional

папка лаунчера; пустой означает каждый профиль.

BookmarkRequestobjectShow propertiesHide properties
idstringoptional

Представлять обновления, которые добавляются в закладки; отсутствие создает его.

urlstringrequired

Голый хост подойдет; Добавлен https://.

titlestringoptional

Бланк использует сам адрес.

folderstringoptional

Пусто (или отсутствует) означает каждый профиль.

TrashEntryobjectShow propertiesHide properties
idstring · uuidoptional
namestringoptional
folderstringoptional
deleted_atinteger · int64optional

Unix-секунды.

expires_atinteger · int64optional

Unix-секунды; очистка при запуске удаляет все, что находится за ней.

size_bytesinteger · int64optional

Архив, в котором хранится аккаунт, а не кэши.

ProfileMetaobject

Метаданные профиля в лаунчере (возвращаются при создании).

Show propertiesHide properties
idstring · uuidoptional
namestringoptional
notesstringoptional
proxy_idstring· nullableoptional
last_launched_atstring· nullableoptional

ISO-8601 или null.

created_atstring· nullableoptional
pinnedbooleanoptional
folderstringoptional
colorstring· nullableoptional

Акцент на значке как #rrggbb; null означает, что оно получено из имени, что и делает браузер, когда ничего не выбрано.

extensionsstring[]optional

Идентификаторы библиотек расширений, загружаемые при запуске.

ProfileListItemobjectShow propertiesHide properties
idstring · uuidoptional
namestringoptional
notesstringoptional
proxy_idstring· nullableoptional
last_launched_atstring· nullableoptional

ISO-8601 или null.

created_atstring· nullableoptional
pinnedbooleanoptional
folderstringoptional
colorstring· nullableoptional

Акцент на значке как #rrggbb; null означает, что оно получено из имени, что и делает браузер, когда ничего не выбрано.

extensionsstring[]optional

Идентификаторы библиотек расширений, загружаемые при запуске.

runningbooleanoptional
pidinteger · int64· nullableoptional
cdpobject · CdpInfo· nullableoptional

CDP-эндпоинт запущенного профиля.

Show propertiesHide properties
portintegeroptional

Порт remote-debugging

http_urlstringoptional

REST-база (/json, /json/version).

web_socket_debugger_urlstringoptional

WS-эндпоинт уровня браузера для Puppeteer/Playwright connect.

StoredProfileobject

Полный профиль на диске: оболочка _meta плюс развёрнутый FingerprintConfig (все поля Fingerprint на верхнем уровне). running/cdp присутствуют только во время работы профиля.

Show propertiesHide properties
_metaobjectoptional
Show propertiesHide properties
idstring · uuidoptional
proxy_idstring· nullableoptional
inline_proxyobject · ProxyEntry· nullableoptional

Полная запись прокси (как встроено в _meta.inline_proxy).

Show propertiesHide properties
idstringoptional
namestringoptional
kindstring · enumoptional
Possible values:socks5httphttps
hoststringoptional
portintegeroptional
usernamestringoptional
passwordstringoptional
countrystringoptional
notesstringoptional
last_launched_atstring· nullableoptional
created_atstring· nullableoptional
pinnedbooleanoptional
folderstringoptional
temporarybooleanoptional
revintegeroptional

Каждая запись увеличивает номер версии. Редактор рабочего стола передает номер версии, на котором был открыт профиль, поэтому сохранение поверх изменения, сделанного через этот API, отклоняется, а не отменяется автоматически. Изменения через API не отклоняются: профиль читается и записывается обратно за один шаг.

runningbooleanoptional
cdpobject · CdpInfo· nullableoptional

CDP-эндпоинт запущенного профиля.

Show propertiesHide properties
portintegeroptional

Порт remote-debugging

http_urlstringoptional

REST-база (/json, /json/version).

web_socket_debugger_urlstringoptional

WS-эндпоинт уровня браузера для Puppeteer/Playwright connect.

CdpInfoobject

CDP-эндпоинт запущенного профиля.

Show propertiesHide properties
portintegeroptional

Порт remote-debugging

http_urlstringoptional

REST-база (/json, /json/version).

web_socket_debugger_urlstringoptional

WS-эндпоинт уровня браузера для Puppeteer/Playwright connect.

RunningProfileobjectShow propertiesHide properties
profile_idstringoptional
pidinteger · int64optional
cdpobject · CdpInfo· nullableoptional

CDP-эндпоинт запущенного профиля.

Show propertiesHide properties
portintegeroptional

Порт remote-debugging

http_urlstringoptional

REST-база (/json, /json/version).

web_socket_debugger_urlstringoptional

WS-эндпоинт уровня браузера для Puppeteer/Playwright connect.

LibraryEntryobjectShow propertiesHide properties
idstringoptional
labelstringoptional
platformstring · enumoptional
Possible values:WindowsmacOSLinux
chromestringoptional

Строка версии Chrome.

gpustringoptional
builtinbooleanoptional

Входит в поставляемый стартовый набор.

AddProxyRequestobject

Строка прокси ИЛИ явные поля (строка имеет приоритет).

Show propertiesHide properties
proxystringoptional

scheme://user:pass@host:port или host:port:user:pass.

kindstring · enumoptional
Possible values:socks5httphttps
hoststringoptional
portintegeroptional
usernamestringoptional
passwordstringoptional
namestringoptional
countrystringoptional
notesstringoptional
ProxySummaryobject

Сохранённый прокси без учётных данных.

Show propertiesHide properties
idstringoptional
namestringoptional
kindstring · enumoptional
Possible values:socks5httphttps
hoststringoptional
portintegeroptional
countrystringoptional

Информационный тег (например

Cookieobject

Cookie в удобном для инструментов виде (совместим с форматами EditThisCookie / Puppeteer; httpOnly/sameSite принимаются как псевдонимы при импорте).

Show propertiesHide properties
domainstringrequired

Хост cookie (Chromium host_key), например ".example.com".

namestringrequired
valuestringrequired
pathstring· default: "/"optional
expiresnumber· nullableoptional

Unix-секунды; null/отсутствует = сессионный cookie.

secureboolean· default: falseoptional
http_onlyboolean· default: falseoptional
same_sitestring · enumoptional

Регистронезависимо при импорте.

Possible values:StrictLaxNoneunspecified
ProxyEntryobject

Полная запись прокси (как встроено в _meta.inline_proxy).

Show propertiesHide properties
idstringoptional
namestringoptional
kindstring · enumoptional
Possible values:socks5httphttps
hoststringoptional
portintegeroptional
usernamestringoptional
passwordstringoptional
countrystringoptional
notesstringoptional
AutomationBranchstring · enum | object

Ветка после выполнения шага. В простых случаях используется строка, при передаче значения - объект.

Show propertiesHide properties
AutomationBlockobject

Один шаг автоматизации. kind и params расширяемы, поэтому модули могут добавлять новые типы шагов.

Show propertiesHide properties
idstringoptional
kindstringoptional

Встроенный тип палитры (goto, click, type, profile.create, var.set, ...) или module:<module id>:<block>.

В мобильном профиле обычные действия используют сенсорный ввод: click выполняет касание, rightClick - долгое нажатие, а scroll и swipe - жесты. hover недоступен, поскольку на мобильном устройстве нет указателя. Следующие шаги доступны только на мобильных профилях и отклоняются на компьютерах:

| Тип | Параметры | Действие | | --- | --- | --- | | touch.tap | selector или x+y, tapCount (1-3), timeout | Коснуться цели. | | touch.longPress | selector или x+y, timeout | Нажать и удерживать. | | touch.swipe | selector или x+y, dx, dy, timeout | Провести пальцем. | | touch.drag | selector, to, holdMs, timeout | Перетащить элемент. | | touch.pinch | scale, selector или x+y | Масштабировать двумя пальцами. Значение выше 1 уменьшает масштаб. | | screen.rotate | angle (0/90/180/270), turnMs, into | Повернуть устройство. into сохраняет новый screen.orientation.type. |

labelstringoptional
paramsobjectoptional

Собственные поля шага, как их определяет палитра.

enabledboolean· default: trueoptional
xnumberoptional

Положение на холсте. Только для макета, выполнение идет по веткам.

ynumberoptional
on_donestring · enum | objectoptional

Ветка после выполнения шага. В простых случаях используется строка, при передаче значения - объект.

on_failany · AutomationBranchoptional

По умолчанию stop. Если продолжить после неудачного шага, действия могут выполняться не на той странице.

secretsstring[]optional

Имена параметров очищаются при экспорте.

AutomationRunSettingsobjectShow propertiesHide properties
threadsinteger· default: 1optional

Максимальное число одновременно работающих браузеров: от 1 до 64.

loopsinteger· default: 1optional

Число проходов по блокам. 0 означает запуск до истечения hours.

hoursnumberoptional

Используется только при loops: 0.

startstringoptional

Идентификатор блока, с которого нужно начать; пустой означает первый.

profilesstring[]optional

Для совместимости с проектами, сохраненными до появления профилей-блоков. При задании каждый профиль запускается в отдельном потоке.

AutomationProjectobjectShow propertiesHide properties
idstring · uuidoptional
namestringoptional
notesstringoptional
blocksobject · AutomationBlock[]optional
Show propertiesHide properties
idstringoptional
kindstringoptional

Встроенный тип палитры (goto, click, type, profile.create, var.set, ...) или module:<module id>:<block>.

В мобильном профиле обычные действия используют сенсорный ввод: click выполняет касание, rightClick - долгое нажатие, а scroll и swipe - жесты. hover недоступен, поскольку на мобильном устройстве нет указателя. Следующие шаги доступны только на мобильных профилях и отклоняются на компьютерах:

| Тип | Параметры | Действие | | --- | --- | --- | | touch.tap | selector или x+y, tapCount (1-3), timeout | Коснуться цели. | | touch.longPress | selector или x+y, timeout | Нажать и удерживать. | | touch.swipe | selector или x+y, dx, dy, timeout | Провести пальцем. | | touch.drag | selector, to, holdMs, timeout | Перетащить элемент. | | touch.pinch | scale, selector или x+y | Масштабировать двумя пальцами. Значение выше 1 уменьшает масштаб. | | screen.rotate | angle (0/90/180/270), turnMs, into | Повернуть устройство. into сохраняет новый screen.orientation.type. |

labelstringoptional
paramsobjectoptional

Собственные поля шага, как их определяет палитра.

enabledboolean· default: trueoptional
xnumberoptional

Положение на холсте. Только для макета, выполнение идет по веткам.

ynumberoptional
on_donestring · enum | objectoptional

Ветка после выполнения шага. В простых случаях используется строка, при передаче значения - объект.

on_failany · AutomationBranchoptional

По умолчанию stop. Если продолжить после неудачного шага, действия могут выполняться не на той странице.

secretsstring[]optional

Имена параметров очищаются при экспорте.

runobject · AutomationRunSettingsoptional
Show propertiesHide properties
threadsinteger· default: 1optional

Максимальное число одновременно работающих браузеров: от 1 до 64.

loopsinteger· default: 1optional

Число проходов по блокам. 0 означает запуск до истечения hours.

hoursnumberoptional

Используется только при loops: 0.

startstringoptional

Идентификатор блока, с которого нужно начать; пустой означает первый.

profilesstring[]optional

Для совместимости с проектами, сохраненными до появления профилей-блоков. При задании каждый профиль запускается в отдельном потоке.

created_atintegeroptional

Unix-секунды.

updated_atintegeroptional

Unix-секунды.

AutomationBundleobject

Пакет проекта для переноса на другую машину.

Show propertiesHide properties
formatintegeroptional

Импорт отклоняет неизвестную версию формата.

exported_atintegeroptional

Unix-секунды.

projectobject · AutomationProjectoptional
Show propertiesHide properties
idstring · uuidoptional
namestringoptional
notesstringoptional
blocksobject · AutomationBlock[]optional
Show propertiesHide properties
idstringoptional
kindstringoptional

Встроенный тип палитры (goto, click, type, profile.create, var.set, ...) или module:<module id>:<block>.

В мобильном профиле обычные действия используют сенсорный ввод: click выполняет касание, rightClick - долгое нажатие, а scroll и swipe - жесты. hover недоступен, поскольку на мобильном устройстве нет указателя. Следующие шаги доступны только на мобильных профилях и отклоняются на компьютерах:

| Тип | Параметры | Действие | | --- | --- | --- | | touch.tap | selector или x+y, tapCount (1-3), timeout | Коснуться цели. | | touch.longPress | selector или x+y, timeout | Нажать и удерживать. | | touch.swipe | selector или x+y, dx, dy, timeout | Провести пальцем. | | touch.drag | selector, to, holdMs, timeout | Перетащить элемент. | | touch.pinch | scale, selector или x+y | Масштабировать двумя пальцами. Значение выше 1 уменьшает масштаб. | | screen.rotate | angle (0/90/180/270), turnMs, into | Повернуть устройство. into сохраняет новый screen.orientation.type. |

labelstringoptional
paramsobjectoptional

Собственные поля шага, как их определяет палитра.

enabledboolean· default: trueoptional
xnumberoptional

Положение на холсте. Только для макета, выполнение идет по веткам.

ynumberoptional
on_donestring · enum | objectoptional

Ветка после выполнения шага. В простых случаях используется строка, при передаче значения - объект.

on_failany · AutomationBranchoptional

По умолчанию stop. Если продолжить после неудачного шага, действия могут выполняться не на той странице.

secretsstring[]optional

Имена параметров очищаются при экспорте.

runobject · AutomationRunSettingsoptional
Show propertiesHide properties
threadsinteger· default: 1optional

Максимальное число одновременно работающих браузеров: от 1 до 64.

loopsinteger· default: 1optional

Число проходов по блокам. 0 означает запуск до истечения hours.

hoursnumberoptional

Используется только при loops: 0.

startstringoptional

Идентификатор блока, с которого нужно начать; пустой означает первый.

profilesstring[]optional

Для совместимости с проектами, сохраненными до появления профилей-блоков. При задании каждый профиль запускается в отдельном потоке.

created_atintegeroptional

Unix-секунды.

updated_atintegeroptional

Unix-секунды.

modulesstring[]optional

Идентификаторы модулей, необходимых проекту.

module_filesobject[]optional

Файлы этих модулей переносятся внутри пакета, чтобы импортированный проект мог работать там, где он находится. Модуль, отсутствующий на диске во время экспорта, здесь не указан, но все равно назван в modules. При импорте модуль, уже установленный под тем же идентификатором, сохраняется как есть, а не перезаписывается.

Show propertiesHide properties
idstringoptional
wasmstringoptional

Файл .wasm, заархивированный gzip, а затем base64.

needsobject[]optional

Поля, очищенные при экспорте и запрашиваемые снова при импорте.

Show propertiesHide properties
block_idstringoptional
labelstringoptional
paramsstring[]optional
AutomationWorkerobject

Один браузер в рамках запуска.

Show propertiesHide properties
profile_idstringoptional
profile_namestringoptional
passintegeroptional

Нумерация с 1; значение 0 означает, что первый проход еще не начался.

stepintegeroptional
steps_totalintegeroptional
statusstring · enumoptional
Possible values:queuedstartingrunningdonefailedstopped
notestringoptional
AutomationRunobjectShow propertiesHide properties
project_idstring · uuidoptional
project_namestringoptional
started_atintegeroptional

Unix-секунды.

runningbooleanoptional
workersobject · AutomationWorker[]optional
Show propertiesHide properties
profile_idstringoptional
profile_namestringoptional
passintegeroptional

Нумерация с 1; значение 0 означает, что первый проход еще не начался.

stepintegeroptional
steps_totalintegeroptional
statusstring · enumoptional
Possible values:queuedstartingrunningdonefailedstopped
notestringoptional
logstring[]optional

Последние записи, показанные в окне запусков. Полный журнал хранится в automation-runs/.

AutomationModuleobjectShow propertiesHide properties
idstringoptional

Имя файла без расширения и префикс для типов блоков модуля.

namestringoptional
pathstringoptional
blocksobject[]optional

Дескрипторы блоков имеют ту же форму, что и встроенная палитра.

errorstringoptional

Пусто при успешной загрузке модуля, иначе содержит причину ошибки.

Обновлено

На этой странице