> 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/italian-documentation/api-di-automazione-e-sdk/local-rest-api.md).

# Usa l'API REST locale

Attiva l'API REST locale di Incogniton in Impostazioni → Automazione, scegli la sua porta e controlla i tuoi profili da script sul tuo computer.

Apri **Impostazioni** nel menu a sinistra e clicca sulla scheda **Automazione**. Attiva **Abilita API di automazione** e clicca su **Salva**. I tuoi script possono quindi raggiungere Incogniton su `http://127.0.0.1:35000`.

L'API REST locale consente agli script e agli strumenti sul tuo computer di elencare, creare, modificare, avviare e fermare i tuoi profili browser. La CLI di Incogniton e gli SDK JavaScript e Python utilizzano tutti questa API.

{% hint style="info" %}
L'API di automazione è una funzionalità a pagamento. Con un piano senza automazione, le impostazioni in questa scheda sono bloccate e la scheda mostra **L'automazione non è inclusa nel tuo piano.** con un link **Aggiorna**.
{% endhint %}

### Accendere o spegnere l'API

{% stepper %}
{% step %}

#### Apri la scheda Automazione

Clicca su **Impostazioni** nel menu a sinistra, poi clicca sulla scheda **Automazione**.
{% endstep %}

{% step %}

#### Accendi l'API

Attiva **Abilita API di automazione**. I campi delle porte e i pulsanti della CLI possono essere utilizzati solo quando questo interruttore è acceso.
{% endstep %}

{% step %}

#### Salva

Clicca su **Salva** nella barra in fondo allo schermo. L'attivazione o la disattivazione dell'API viene applicata non appena salvi.
{% endstep %}
{% endstepper %}

L'app Incogniton deve essere aperta e connessa affinché l'API funzioni. Quando chiudi l'app, anche l'API si ferma.

### Cambiare la porta dell'API

L'API ascolta sulla porta **35000** per impostazione predefinita. Per utilizzare un'altra porta, inseriscila nel campo **Porta API** e clicca su **Salva**. Un nuovo numero di porta viene utilizzato la prossima volta che avvii Incogniton.

Se un altro programma utilizza già la porta, Incogniton mostra un messaggio che la porta è già in uso e non avvia l'API. Puoi risolvere questo problema in due modi:

* Inserisci una porta libera in **Porta API**.
* Attiva **Usa la prossima porta libera se quella configurata è occupata**. Incogniton sceglierà quindi la prossima porta libera. Mentre l'API è in esecuzione, la scheda mostra la porta che sta effettivamente utilizzando: "L'API REST è attualmente in esecuzione sulla porta …".

Il campo **Porta Selenium** (predefinito 4444) imposta la porta della griglia Selenium che Incogniton esegue accanto all'API per gli script Selenium.

### Chi può raggiungere l'API

L'API ascolta solo su `127.0.0.1` (localhost). Altri computer sulla tua rete non possono connettersi ad essa. Anche i siti web che visiti non possono inviare richieste ad essa tramite il tuo browser. Gli script, la CLI e gli SDK in esecuzione sullo stesso computer funzionano normalmente.

L'API funziona con l'account che è connesso all'app. Vede gli stessi profili che vedi nell'app.

### Cosa puoi fare con l'API

Con l'API puoi elencare, creare, modificare, clonare e eliminare profili, avviarli e fermarli, leggere e modificare i loro cookie, e avviare un profilo per Puppeteer, Playwright o Selenium. Per chiamare un profilo hai bisogno del suo ID: espandi il profilo nell'elenco dei profili e clicca su **Copia** accanto a **ID Profilo**.

Gli endpoint, i loro parametri e le richieste di esempio sono nella documentazione per sviluppatori:

* [Quickstart](https://api-docs.incogniton.com/getting-started/quickstart): la tua prima chiamata in pochi minuti.
* [Riferimento API](https://api-docs.incogniton.com/apis): ogni endpoint. Puoi anche aprirlo dal link **Documentazione API** nella scheda Automazione.
* [Esempi di automazione](https://api-docs.incogniton.com/how-to-guides/automation-examples): script Puppeteer, Playwright e Selenium pronti per l'esecuzione.

### Usa la CLI o un SDK invece

Non devi scrivere tu stesso le chiamate HTTP:

* **Incogniton CLI**: esegui le stesse azioni come comandi in un terminale. Clicca su **Scarica CLI** nella scheda Automazione; mentre è installata, si aggiorna automaticamente quando l'app si avvia. Vedi la [documentazione CLI](https://api-docs.incogniton.com/cli).
* [**JavaScript e Python SDK**](https://docs.incogniton.com/documentation/italian-documentation/api-di-automazione-e-sdk/javascript-and-python-sdk.md): chiama l'API dal codice.
* [**Connetti client AI (MCP)**](https://docs.incogniton.com/documentation/italian-documentation/api-di-automazione-e-sdk/connect-ai-clients-mcp.md): lascia che un client AI come Claude o Cursor gestisca i tuoi profili.
