Локальный API
Локальный API позволяет скриптам на вашем компьютере создавать, запускать и останавливать профили. Доступен с тарифа Base.
Включить
- Настройки → Автоматизация → Включить API.
- По умолчанию адрес http://127.0.0.1:47125. Порт можно поменять (1024–65535).
- Скопируйте Токен. Новый выпускает новый токен и отзывает старый.
Маршруты
- GET /v1/profiles — список
- POST /v1/profiles — создать (name, proxy, platform, group, tags, notes, cookies, autofill, totp)
- GET /v1/profiles/{id} — один профиль
- POST /v1/profiles/{id}/start — запустить; в ответе port и ws_endpoint для подключения
- POST /v1/profiles/{id}/stop — остановить
- POST /v1/profiles/{id}/cookies — загрузить cookies (JSON или Netscape): в открытый браузер сразу, в закрытый — при следующем запуске
- DELETE /v1/profiles/{id} — в корзину
- POST /v1/sync — синхронизатор окон
Авторизация
Заголовок Authorization: Bearer <токен>. API слушает только этот компьютер (127.0.0.1).
Возможные ошибки
Неверный токен. Он показан в настройках, раздел «Автоматизация».
Почему: В запросе нет токена или он устарел.
Что делать: Скопируйте актуальный токен из Автоматизация.
Порт N занят другой программой. Выберите другой порт.
Почему: Порт уже слушает другое приложение.
Что делать: Укажите другой Порт и включите API снова.
Профиль уже открыт из приложения, без DevTools. Остановите его и запустите через API.
Почему: Профиль, запущенный кнопкой в приложении, не открывает порт DevTools.
Что делать: Остановите профиль и запустите запросом /start.
Профиль не запущен.
Почему: Остановить или подключиться можно только к запущенному профилю.
Что делать: Сначала запустите его через /start.
Локальный API (автоматизация) доступен на тарифе Base и выше.
Почему: Функция тарифа Base.
Что делать: Перейдите на Base или выше.