Локальный API автоматизации
Откройте «API автоматизации» на боковой панели и нажмите «Запустить локальный API». Prism покажет адрес API (случайный порт на 127.0.0.1) и токен доступа для текущего сеанса. Токен показывается только один раз и перестает действовать после остановки API.
| Запрос | Назначение |
|---|---|
| GET /v1/status | Состояние службы |
| GET /v1/profiles | Список профилей: номер, имя, группа, теги, статус, время последнего открытия |
| GET /v1/profiles/{id}/status | Статус отдельного профиля |
| POST /v1/profiles/{id}/start | Запуск профиля с той же предварительной проверкой прокси и теми же ограничениями одновременных запусков, что и в интерфейсе |
| POST /v1/profiles/{id}/close | Закрытие профиля |
| POST /v1/profiles | Создание одного профиля с заданными именем, группой, прокси и отпечатком (с версии 0.3.22) |
| POST /v1/profiles/batch | Создание 1–50 профилей за раз; профили сохраняются, только если все прошли проверку (с версии 0.3.22) |
curl -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles
curl -X POST -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles/$PROFILE_ID/start- Принимаются только запросы с этого компьютера: заголовок Host должен совпадать с адресом API, а запросы с браузерным заголовком Origin или параметрами строки запроса отклоняются (тело в формате JSON принимают только эндпоинты создания), поэтому веб-страницы не могут обращаться к API напрямую.
- Не более 120 запросов в минуту (лимит общий с локальным мостом MCP).
- API может создавать профили, получать сведения о них, запускать и закрывать их, но не может изменять или удалять профили и не читает данные браузера. Сам API не предоставляет отладочных эндпоинтов для Puppeteer / Playwright (версия для Windows открывает на 127.0.0.1 случайный отладочный порт для внутреннего управления, но это не публичный интерфейс).
- «Экстренно остановить» закрывает профили, запущенные через API; вызовы записываются в локальный журнал аудита.
Правила запросов, поля ответов, коды ошибок и примеры на Python / Node.js — в справочнике по локальному API.
Локальные запланированные задачи
| Параметр | Возможные значения |
|---|---|
| Действие | Запустить профиль / Закрыть профиль |
| Режим повтора | Один раз / Ежедневно / Еженедельно (можно выбрать несколько дней, с воскресенья по субботу) |
| Время выполнения | Время и часовой пояс этого компьютера |
| Пропущенный запуск | Выполнить один раз в течение 24 часов / Пропустить запуск |
| Повторы при ошибке | 0–3 повтора с интервалом 1–60 минут |
- Запланированные задачи выполняются, только пока Prism запущен: постоянного фонового процесса нет. Каждые 15 секунд Prism проверяет, не пора ли выполнить задачи; одновременно выполняется не более 2 задач.
- Задачу можно проверить кнопкой «Запустить сейчас». Профиль, который используется в запланированной задаче, можно удалить только после того, как вы уберете его из задачи.
- Если лицензия Pro перестает действовать, выполнение по расписанию приостанавливается; задачи сохраняются, и их по-прежнему можно отключить или удалить.
Примеры совместного использования
Рабочие профили готовы к началу дня
Часто используемые профили запускаются каждый день в 09:00 и закрываются в конце рабочего дня — меньше ручных действий и случайных запусков.
Массовый запуск и остановка из скрипта
В своем скрипте сначала вызовите GET /v1/profiles, чтобы найти ID профилей, а затем запускайте их по очереди — логика запуска та же, что и в интерфейсе.
Дальше работает ИИ
После запуска профилей MCP читает страницы и выполняет следующие шаги в профилях, к которым вы разрешили доступ.
Частые вопросы
- Можно ли запускать собственные скрипты или RPA-сценарии?
- Запланированные задачи умеют только запускать и закрывать профили, а API тоже не выполняет скрипты. Для действий на уровне страниц используйте MCP из Pro или установите в профиль нужное расширение.
- Совместим ли API с API других антидетект-браузеров?
- Нет. Prism использует собственный локальный интерфейс, пути приведены в таблице выше.
- Выполняются ли запланированные задачи, если Prism закрыт?
- Нет. Для запланированных задач нужен запущенный Prism; пропущенную задачу, в зависимости от настройки, можно один раз выполнить позже в течение 24 часов.