# RPA для браузера

RPA для браузера автоматизує повторювані завдання в локальному профілі браузера Chromium: відкриває сторінки, взаємодіє з елементами, зчитує результати та керує ходом виконання за допомогою умов і циклів. Ви створюєте сценарій як шаблон, зберігаєте його у своєму обліковому записі MoreLogin і запускаєте в профілі браузера через настільний клієнт або через Local API RPA для браузера.

Цей розділ призначено для розробників і ШІ-агентів, які програмно створюють і запускають шаблони. Про автоматизацію хмарних телефонів Android див. [RPA для хмарних телефонів](/uk/rparobotic-process-automation/01-overview/01-rpa-introduction).

## Вимоги

- Запущено настільний клієнт MoreLogin V2.73.0 або новіший, і в ньому виконано вхід. Шаблони зберігаються в обліковому записі, у який виконано вхід, і відображаються в клієнті в розділі **Власні шаблони**.
- Local API доступний за адресою `http://127.0.0.1:<port>/api/rpa/browser/v1`. Використовуйте порт Local API, указаний у налаштуваннях клієнта; за замовчуванням це `40000`.
- Автентифікація працює так само, як і для решти Local API. Див. [Автентифікація](/uk/api-reference/getting-started/authentication).
- Для запусків потрібен профіль браузера Chromium (`browserTypeId: 1`).
- `GET /capabilities` повертає операції, ліміти й URL-адреси документації, доступні для вашого клієнта та облікового запису. Виконайте цей запит, перш ніж створювати шаблон.


## Основні поняття

| Поняття | Значення |
|  --- | --- |
| Шаблон | Збережений сценарій із назвою, описом і залежностями від дочірніх шаблонів. Кожне збереження створює нову версію. |
| Сценарій | Упорядковане дерево вузлів у шаблоні. Воно починається з одного вузла `start` і закінчується одним вузлом `end`. |
| Вузол | Один крок, наприклад відкриття URL або натискання на елемент. Кожен тип вузла має контракт, який визначає його вхідні та вихідні дані. |
| Середовище | Профіль браузера, який використовує запуск. Значенням `environmentId` є `envId` профілю з [Local API браузера](/uk/api-reference/browser/local-api). |
| Запуск | Одне виконання збереженої версії шаблону в середовищі. Запуск має записи виконання вузлів і артефакти. |
| Квитанція запиту | Збережений результат запиту на запис, надісланого із заголовком `Idempotency-Key`. За квитанцією можна з'ясувати, що сталося після тайм-ауту. |


## Чим цей API відрізняється від інших ендпоінтів Local API

Ендпоінти RPA для браузера не використовують формат `{code, msg, data}`, описаний у розділі [Загальний формат відповіді](/uk/api-reference/getting-started/response-format).

- Вони повертають справжні коди стану HTTP, наприклад 201, 202, 409, 412, 422, 429 і 503.
- Тіло успішної відповіді має формат `{data, meta}`, а тіло відповіді з помилкою має формат `{error, meta}`. Коди помилок є рядками, наприклад `RPA_VALIDATION_FAILED`; див. [Коди помилок](/uk/browser-rpa/api/error-codes).
- Запити на запис використовують заголовки `Idempotency-Key`, `If-Match` і `X-RPA-Catalog-Revision`. Див. [Обов'язкові заголовки для запитів на запис](/uk/browser-rpa/local-api#%D0%BE%D0%B1%D0%BE%D0%B2%D1%8F%D0%B7%D0%BA%D0%BE%D0%B2%D1%96-%D0%B7%D0%B0%D0%B3%D0%BE%D0%BB%D0%BE%D0%B2%D0%BA%D0%B8-%D0%B4%D0%BB%D1%8F-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%96%D0%B2-%D0%BD%D0%B0-%D0%B7%D0%B0%D0%BF%D0%B8%D1%81).
- Помилки автентифікації повертаються в стандартному для Local API форматі 401.


## Початок роботи

1. [Швидкий старт](/uk/browser-rpa/quickstart): отримайте можливості та контракти вузлів, а потім перевірте й збережіть шаблон, який повертає кінцеву URL-адресу сторінки.
2. [Запуск шаблону через API](/uk/browser-rpa/run-api-example): виконайте попередню перевірку збереженої версії, почніть запуск і прочитайте результат.
3. [Спільні поля та структура сценарію](/uk/browser-rpa/node-contract-guide): ознайомтеся з будовою сценарію, посиланнями, тайм-аутами та повторними спробами.
4. [Каталог вузлів](/uk/browser-rpa/nodes): знайдіть вхідні дані, значення за замовчуванням, посилання та вихідні дані кожного вузла.
5. [Довідник Local API](/uk/browser-rpa/local-api): знайдіть усі ендпоінти й заголовки, потрібні для запису, і дізнайтеся, як відновлюватися після тайм-аутів і конфліктів версій.


Щоб запустити шаблон вручну, див. [Запуск шаблону в настільному клієнті](/uk/browser-rpa/run).