> 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/pt-br-documentation/api-de-automacao-e-sdks/local-rest-api.md).

# Usar a API REST local

Ative a API REST local do Incogniton em Configurações → Automação, escolha sua porta e controle seus perfis a partir de scripts no seu próprio computador.

Abra **Configurações** no menu à esquerda e clique na aba **Automação**. Ative **Habilitar API de automação** e clique em **Salvar**. Seus scripts poderão então acessar o Incogniton em `http://127.0.0.1:35000`.

A API REST local permite que scripts e ferramentas em seu computador listem, criem, editem, iniciem e parem seus perfis de navegador. O CLI do Incogniton e os SDKs de JavaScript e Python usam essa API.

{% hint style="info" %}
A API de automação é um recurso pago. Em um plano sem automação, as configurações nesta aba estão bloqueadas e a aba mostra **Automação não está incluída no seu plano.** com um link de **Upgrade**.
{% endhint %}

### Ativar ou desativar a API

{% stepper %}
{% step %}

#### Abra a aba Automação

Clique em **Configurações** no menu à esquerda e depois clique na aba **Automação**.
{% endstep %}

{% step %}

#### Ative a API

Ative **Habilitar API de automação**. Os campos de porta e os botões do CLI só podem ser usados enquanto este interruptor estiver ativado.
{% endstep %}

{% step %}

#### Salvar

Clique em **Salvar** na barra na parte inferior da tela. Ativar ou desativar a API é aplicado assim que você salva.
{% endstep %}
{% endstepper %}

O aplicativo Incogniton deve estar aberto e logado para que a API funcione. Quando você fecha o aplicativo, a API também para.

### Alterar a porta da API

A API escuta na porta **35000** por padrão. Para usar outra porta, insira-a no campo **Porta da API** e clique em **Salvar**. Um novo número de porta é usado na próxima vez que você iniciar o Incogniton.

Se outro programa já estiver usando a porta, o Incogniton mostrará uma mensagem de que a porta já está em uso e não iniciará a API. Você pode resolver isso de duas maneiras:

* Insira uma porta livre em **Porta da API**.
* Ative **Usar próxima porta livre se a configurada estiver ocupada**. O Incogniton então escolherá a próxima porta livre. Enquanto a API estiver em execução, a aba mostrará a porta que está realmente usando: "A API REST está atualmente em execução na porta …".

O campo **Porta do Selenium** (padrão 4444) define a porta do grid do Selenium que o Incogniton executa ao lado da API para scripts do Selenium.

### Quem pode acessar a API

A API só escuta em `127.0.0.1` (localhost). Outros computadores na sua rede não podem se conectar a ela. Sites que você visita também não podem enviar solicitações a ela através do seu navegador. Scripts, o CLI e os SDKs que rodam no mesmo computador funcionam normalmente.

A API funciona com a conta que está logada no aplicativo. Ela vê os mesmos perfis que você vê no aplicativo.

### O que você pode fazer com a API

Com a API você pode listar, criar, editar, clonar e excluir perfis, iniciá-los e pará-los, ler e alterar seus cookies, e iniciar um perfil para Puppeteer, Playwright ou Selenium. Para chamar um perfil, você precisa do seu ID: expanda o perfil na lista de perfis e clique em **Copiar** ao lado de **ID do Perfil**.

Os endpoints, seus parâmetros e exemplos de solicitações estão na documentação do desenvolvedor:

* [Início rápido](https://api-docs.incogniton.com/getting-started/quickstart): sua primeira chamada em poucos minutos.
* [Referência da API](https://api-docs.incogniton.com/apis): todos os endpoints. Você também pode abri-la a partir do link **Documentação da API** na aba Automação.
* [Exemplos de automação](https://api-docs.incogniton.com/how-to-guides/automation-examples): scripts prontos para rodar de Puppeteer, Playwright e Selenium.

### Use o CLI ou um SDK em vez disso

Você não precisa escrever chamadas HTTP você mesmo:

* **Incogniton CLI**: execute as mesmas ações como comandos em um terminal. Clique em **Baixar CLI** na aba Automação; enquanto estiver instalado, ele se atualiza quando o aplicativo é iniciado. Veja a [documentação do CLI](https://api-docs.incogniton.com/cli).
* [**SDK de JavaScript e Python**](https://docs.incogniton.com/documentation/pt-br-documentation/api-de-automacao-e-sdks/javascript-and-python-sdk.md): chame a API a partir do código.
* [**Conectar clientes de IA (MCP)**](https://docs.incogniton.com/documentation/pt-br-documentation/api-de-automacao-e-sdks/connect-ai-clients-mcp.md): permita que um cliente de IA, como Claude ou Cursor, gerencie seus perfis.
