> 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/spanish/api-de-automatizacion-y-sdks/local-rest-api.md).

# Usar la API REST local

Activa la API REST local de Incogniton en Configuración → Automatización, elige su puerto y controla tus perfiles desde scripts en tu propia computadora.

Abre **Configuración** en el menú lateral izquierdo y haz clic en la pestaña **Automatización**. Activa **Habilitar API de automatización** y haz clic en **Guardar**. Tus scripts podrán acceder a Incogniton en `http://127.0.0.1:35000`.

La API REST local permite que scripts y herramientas en tu computadora enumeren, creen, editen, inicien y detengan tus perfiles de navegador. La CLI de Incogniton y los SDK de JavaScript y Python utilizan esta API.

{% hint style="info" %}
La API de automatización es una función de pago. En un plan sin automatización, la configuración en esta pestaña está bloqueada y la pestaña muestra **La automatización no está incluida en tu plan.** con un enlace de **Actualizar**.
{% endhint %}

### Activar o desactivar la API

{% stepper %}
{% step %}

#### Abre la pestaña de Automatización

Haz clic en **Configuración** en el menú lateral izquierdo, luego haz clic en la pestaña **Automatización**.
{% endstep %}

{% step %}

#### Activa la API

Activa **Habilitar API de automatización**. Los campos de puerto y los botones de CLI solo se pueden usar mientras este interruptor esté activado.
{% endstep %}

{% step %}

#### Guardar

Haz clic en **Guardar** en la barra en la parte inferior de la pantalla. Activar o desactivar la API se aplica tan pronto como guardes.
{% endstep %}
{% endstepper %}

La aplicación Incogniton debe estar abierta y con sesión iniciada para que la API funcione. Cuando cierras la aplicación, la API también se detiene.

### Cambiar el puerto de la API

La API escucha en el puerto **35000** por defecto. Para usar otro puerto, introdúcelo en el campo **Puerto de API** y haz clic en **Guardar**. Se utilizará un nuevo número de puerto la próxima vez que inicies Incogniton.

Si otro programa ya está usando el puerto, Incogniton muestra un mensaje de que el puerto ya está en uso y no inicia la API. Puedes solucionar esto de dos maneras:

* Introduce un puerto libre en **Puerto de API**.
* Activa **Usar el siguiente puerto libre si el configurado está ocupado**. Incogniton entonces elige el siguiente puerto libre. Mientras la API se ejecuta, la pestaña muestra el puerto que realmente utiliza: "La API REST está actualmente ejecutándose en el puerto …".

El campo **Puerto de Selenium** (por defecto 4444) establece el puerto de la cuadrícula de Selenium que Incogniton ejecuta junto a la API para scripts de Selenium.

### Quién puede acceder a la API

La API solo escucha en `127.0.0.1` (localhost). Otras computadoras en tu red no pueden conectarse a ella. Los sitios web que visitas tampoco pueden enviar solicitudes a través de tu navegador. Los scripts, la CLI y los SDK que se ejecutan en la misma computadora funcionan normalmente.

La API funciona con la cuenta que ha iniciado sesión en la aplicación. Ve los mismos perfiles que ves en la aplicación.

### Qué puedes hacer con la API

Con la API puedes listar, crear, editar, clonar y eliminar perfiles, iniciarlos y detenerlos, leer y cambiar sus cookies, e iniciar un perfil para Puppeteer, Playwright o Selenium. Para llamar a un perfil necesitas su ID: expande el perfil en la lista de perfiles y haz clic en **Copiar** junto a **ID de perfil**.

Los endpoints, sus parámetros y solicitudes de ejemplo están en la documentación para desarrolladores:

* [Inicio rápido](https://api-docs.incogniton.com/getting-started/quickstart): tu primera llamada en pocos minutos.
* [Referencia de API](https://api-docs.incogniton.com/apis): cada endpoint. También puedes abrirla desde el enlace **Documentación de API** en la pestaña de Automatización.
* [Ejemplos de automatización](https://api-docs.incogniton.com/how-to-guides/automation-examples): scripts listos para ejecutar de Puppeteer, Playwright y Selenium.

### Usar la CLI o un SDK en su lugar

No tienes que escribir llamadas HTTP tú mismo:

* **Incogniton CLI**: ejecuta las mismas acciones como comandos en una terminal. Haz clic en **Descargar CLI** en la pestaña de Automatización; mientras está instalada, se actualiza automáticamente cuando la aplicación se inicia. Consulta la [documentación de CLI](https://api-docs.incogniton.com/cli).
* [**SDK de JavaScript y Python**](https://docs.incogniton.com/documentation/spanish/api-de-automatizacion-y-sdks/javascript-and-python-sdk.md): llama a la API desde el código.
* [**Conectar clientes AI (MCP)**](https://docs.incogniton.com/documentation/spanish/api-de-automatizacion-y-sdks/connect-ai-clients-mcp.md): permite que un cliente AI como Claude o Cursor gestione tus perfiles.
