> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/russian-documentation/api-avtomatizacii-i-sdk/local-rest-api.md).

# Использование локального REST API

Включите локальный REST API Incogniton в Настройки → Автоматизация, выберите его порт и управляйте своими профилями из скриптов на вашем компьютере.

Откройте **Настройки** в меню слева и нажмите на вкладку **Автоматизация**. Включите **Включить API автоматизации** и нажмите **Сохранить**. Ваши скрипты смогут обращаться к Incogniton по адресу `http://127.0.0.1:35000`.

Локальный REST API позволяет скриптам и инструментам на вашем компьютере перечислять, создавать, редактировать, запускать и останавливать ваши браузерные профили. CLI Incogniton и SDK для JavaScript и Python используют этот API.

{% hint style="info" %}
API автоматизации — платная функция. В плане без автоматизации настройки на этой вкладке заблокированы, и вкладка показывает **Автоматизация не включена в ваш план.** с ссылкой **Обновить**.
{% endhint %}

### Включение или выключение API

{% stepper %}
{% step %}

#### Откройте вкладку Автоматизация

Нажмите **Настройки** в меню слева, затем нажмите на вкладку **Автоматизация**.
{% endstep %}

{% step %}

#### Включите API

Включите **Включить API автоматизации**. Поля портов и кнопки CLI можно использовать только при включенном переключателе.
{% endstep %}

{% step %}

#### Сохраните

Нажмите **Сохранить** в панели внизу экрана. Включение или выключение API применяется сразу после сохранения.
{% endstep %}
{% endstepper %}

Приложение Incogniton должно быть открыто и авторизовано для работы API. Когда вы закрываете приложение, API также прекращает работу.

### Изменение порта API

API по умолчанию слушает порт **35000**. Чтобы использовать другой порт, введите его в поле **API порт** и нажмите **Сохранить**. Новый номер порта будет использоваться при следующем запуске Incogniton.

Если другой программой уже используется этот порт, Incogniton показывает сообщение, что порт уже занят, и не запускает API. Вы можете исправить это двумя способами:

* Введите свободный порт в **API порт**.
* Включите **Использовать следующий свободный порт, если настроенный занят**. Incogniton выберет следующий свободный порт. Пока API работает, вкладка показывает порт, который он фактически использует: "REST API в настоящее время работает на порту …".

Поле **Selenium порт** (по умолчанию 4444) задает порт сетки Selenium, которую Incogniton запускает рядом с API для скриптов Selenium.

### Кто может подключиться к API

API слушает только на `127.0.0.1` (localhost). Другие компьютеры в вашей сети не могут подключиться к нему. Веб-сайты, которые вы посещаете, также не могут отправлять запросы через ваш браузер. Скрипты, CLI и SDK, работающие на том же компьютере, работают нормально.

API работает с учетной записью, которая авторизована в приложении. Он видит те же профили, что и вы в приложении.

### Что можно делать с API

С помощью API вы можете перечислять, создавать, редактировать, клонировать и удалять профили, запускать и останавливать их, читать и изменять их куки, а также запускать профиль для Puppeteer, Playwright или Selenium. Чтобы вызвать профиль, вам нужен его ID: разверните профиль в списке профилей и нажмите **Копировать** рядом с **ID профиля**.

Конечные точки, их параметры и примеры запросов находятся в документации для разработчиков:

* [Быстрый старт](https://api-docs.incogniton.com/getting-started/quickstart): ваш первый вызов за несколько минут.
* [Справочник API](https://api-docs.incogniton.com/apis): каждая конечная точка. Вы также можете открыть его по ссылке **Документация API** на вкладке Автоматизация.
* [Примеры автоматизации](https://api-docs.incogniton.com/how-to-guides/automation-examples): готовые к запуску скрипты Puppeteer, Playwright и Selenium.

### Используйте CLI или SDK вместо этого

Вам не нужно писать HTTP-вызовы самостоятельно:

* **Incogniton CLI**: выполняйте те же действия в виде команд в терминале. Нажмите **Скачать CLI** на вкладке Автоматизация; пока он установлен, он обновляется при запуске приложения. См. [документацию CLI](https://api-docs.incogniton.com/cli).
* [**JavaScript и Python SDK**](https://docs.incogniton.com/documentation/russian-documentation/api-avtomatizacii-i-sdk/javascript-and-python-sdk.md): вызывайте API из кода.
* [**Подключение AI-клиентов (MCP)**](https://docs.incogniton.com/documentation/russian-documentation/api-avtomatizacii-i-sdk/connect-ai-clients-mcp.md): позвольте AI-клиенту, такому как Claude или Cursor, управлять вашими профилями.
