Локальний 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 секунд, одночасно виконується не більше 2.
- Завдання можна перевірити кнопкою «Запустити зараз»; профіль, який використовується в запланованому завданні, можна видалити лише після того, як його прибрано із завдання.
- Якщо ліцензія Pro стає недійсною, виконання за розкладом призупиняється; завдання зберігаються, і їх можна вимкнути або видалити.
Приклади спільного використання
Робочі профілі відкриваються автоматично на початку робочого дня
Щодня о 09:00 запускайте профілі, якими часто користуєтеся, і закривайте їх наприкінці робочого дня — менше ручної роботи й випадкових відкриттів.
Пакетний запуск і зупинка зі скрипта
У власному скрипті спершу викличте GET /v1/profiles, щоб знайти ID профілів, а потім запускайте їх по черзі — логіка запуску та сама, що й в інтерфейсі.
Далі працює ШІ
Після запуску профілю MCP дає змогу ШІ читати сторінки й виконувати наступні кроки в дозволених вами профілях.
Поширені запитання
- Чи можна запускати власні скрипти або сценарії RPA?
- Заплановані завдання підтримують лише запуск і закриття профілів, а API не виконує скриптів. Для дій на рівні сторінок скористайтеся MCP у Pro або самостійно встановіть розширення в профіль.
- Чи сумісний API з іншими антидетект-браузерами?
- Ні. Prism використовує власний локальний інтерфейс, шляхи наведено в таблиці вище.
- Чи виконуються заплановані завдання, коли Prism закрито?
- Ні. Для виконання запланованих завдань Prism має бути запущено; пропущене завдання, залежно від налаштувань, можна виконати один раз протягом 24 годин.