> 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/german-documentation-1/automatisierungs-api-und-sdks/local-rest-api.md).

# Die lokale REST-API verwenden

Aktivieren Sie die lokale REST-API von Incogniton in Einstellungen → Automatisierung, wählen Sie den Port und steuern Sie Ihre Profile von Skripten auf Ihrem eigenen Computer aus.

Öffnen Sie **Einstellungen** im Menü auf der linken Seite und klicken Sie auf den Tab **Automatisierung**. Schalten Sie **Automatisierungs-API aktivieren** ein und klicken Sie auf **Speichern**. Ihre Skripte können dann über `http://127.0.0.1:35000` auf Incogniton zugreifen.

Die lokale REST-API ermöglicht es Skripten und Tools auf Ihrem Computer, Ihre Browserprofile aufzulisten, zu erstellen, zu bearbeiten, zu starten und zu stoppen. Die Incogniton CLI sowie die JavaScript- und Python-SDKs verwenden alle diese API.

{% hint style="info" %}
Die Automatisierungs-API ist eine kostenpflichtige Funktion. Bei einem Plan ohne Automatisierung sind die Einstellungen auf diesem Tab gesperrt und der Tab zeigt **Automatisierung ist in Ihrem Plan nicht enthalten.** mit einem **Upgrade**-Link.
{% endhint %}

### Die API ein- oder ausschalten

{% stepper %}
{% step %}

#### Öffnen Sie den Automatisierungs-Tab

Klicken Sie auf **Einstellungen** im Menü auf der linken Seite und dann auf den Tab **Automatisierung**.
{% endstep %}

{% step %}

#### Schalten Sie die API ein

Schalten Sie **Automatisierungs-API aktivieren** ein. Die Portfelder und die CLI-Schaltflächen können nur verwendet werden, wenn dieser Schalter eingeschaltet ist.
{% endstep %}

{% step %}

#### Speichern

Klicken Sie auf **Speichern** in der Leiste am unteren Bildschirmrand. Das Ein- oder Ausschalten der API wird angewendet, sobald Sie speichern.
{% endstep %}
{% endstepper %}

Die Incogniton-App muss geöffnet und eingeloggt sein, damit die API funktioniert. Wenn Sie die App schließen, stoppt auch die API.

### Ändern Sie den API-Port

Die API hört standardmäßig auf Port **35000**. Um einen anderen Port zu verwenden, geben Sie ihn im Feld **API-Port** ein und klicken Sie auf **Speichern**. Eine neue Portnummer wird beim nächsten Start von Incogniton verwendet.

Wenn ein anderes Programm den Port bereits verwendet, zeigt Incogniton eine Nachricht an, dass der Port bereits in Gebrauch ist, und startet die API nicht. Sie können dies auf zwei Arten beheben:

* Geben Sie einen freien Port im **API-Port** ein.
* Schalten Sie **Nächsten freien Port verwenden, wenn der konfigurierte belegt ist** ein. Incogniton wählt dann den nächsten freien Port. Während die API läuft, zeigt der Tab den tatsächlich verwendeten Port an: "Die REST-API läuft derzeit auf Port …".

Das Feld **Selenium-Port** (Standard 4444) legt den Port des Selenium-Grids fest, das Incogniton neben der API für Selenium-Skripte betreibt.

### Wer kann auf die API zugreifen

Die API hört nur auf `127.0.0.1` (localhost). Andere Computer in Ihrem Netzwerk können nicht darauf zugreifen. Websites, die Sie besuchen, können über Ihren Browser ebenfalls keine Anfragen an sie senden. Skripte, die CLI und die SDKs, die auf demselben Computer laufen, funktionieren normal.

Die API arbeitet mit dem Konto, das in der App eingeloggt ist. Sie sieht dieselben Profile, die Sie in der App sehen.

### Was Sie mit der API tun können

Mit der API können Sie Profile auflisten, erstellen, bearbeiten, klonen und löschen, sie starten und stoppen, ihre Cookies lesen und ändern und ein Profil für Puppeteer, Playwright oder Selenium starten. Um ein Profil aufzurufen, benötigen Sie seine ID: Erweitern Sie das Profil in der Profilliste und klicken Sie auf **Kopieren** neben **Profil-ID**.

Die Endpunkte, ihre Parameter und Beispielanfragen finden Sie in der Entwicklerdokumentation:

* [Schnellstart](https://api-docs.incogniton.com/getting-started/quickstart): Ihr erster Aufruf in wenigen Minuten.
* [API-Referenz](https://api-docs.incogniton.com/apis): Jeder Endpunkt. Sie können sie auch über den Link **API-Dokumentation** auf dem Automatisierungs-Tab öffnen.
* [Automatisierungsbeispiele](https://api-docs.incogniton.com/how-to-guides/automation-examples): Fertige Puppeteer-, Playwright- und Selenium-Skripte.

### Verwenden Sie stattdessen die CLI oder ein SDK

Sie müssen keine HTTP-Aufrufe selbst schreiben:

* **Incogniton CLI**: Führen Sie dieselben Aktionen als Befehle in einem Terminal aus. Klicken Sie auf **CLI herunterladen** auf dem Automatisierungs-Tab; während es installiert ist, aktualisiert es sich selbst, wenn die App startet. Siehe die [CLI-Dokumentation](https://api-docs.incogniton.com/cli).
* [**JavaScript- und Python-SDK**](https://docs.incogniton.com/documentation/german-documentation-1/automatisierungs-api-und-sdks/javascript-and-python-sdk.md): Rufen Sie die API aus dem Code auf.
* [**AI-Clients verbinden (MCP)**](https://docs.incogniton.com/documentation/german-documentation-1/automatisierungs-api-und-sdks/connect-ai-clients-mcp.md): Lassen Sie einen AI-Client wie Claude oder Cursor Ihre Profile verwalten.
