> 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/french-documentation/api-dautomation-et-sdks/local-rest-api.md).

# Utiliser l'API REST locale

Activez l'API REST locale d'Incogniton dans Paramètres → Automatisation, choisissez son port, et contrôlez vos profils depuis des scripts sur votre propre ordinateur.

Ouvrez **Paramètres** dans le menu de gauche et cliquez sur l'onglet **Automatisation**. Activez **Activer l'API d'automatisation** et cliquez sur **Enregistrer**. Vos scripts peuvent alors accéder à Incogniton à `http://127.0.0.1:35000`.

L'API REST locale permet aux scripts et outils sur votre ordinateur de lister, créer, éditer, lancer et arrêter vos profils de navigateur. L'interface CLI d'Incogniton et les SDK JavaScript et Python utilisent tous cette API.

{% hint style="info" %}
L'API d'automatisation est une fonctionnalité payante. Sur un plan sans automatisation, les paramètres de cet onglet sont verrouillés et l'onglet affiche **L'automatisation n'est pas incluse dans votre plan.** avec un lien **Mettre à niveau**.
{% endhint %}

### Activer ou désactiver l'API

{% stepper %}
{% step %}

#### Ouvrir l'onglet Automatisation

Cliquez sur **Paramètres** dans le menu de gauche, puis cliquez sur l'onglet **Automatisation**.
{% endstep %}

{% step %}

#### Activer l'API

Activez **Activer l'API d'automatisation**. Les champs de port et les boutons CLI ne peuvent être utilisés que lorsque cet interrupteur est activé.
{% endstep %}

{% step %}

#### Enregistrer

Cliquez sur **Enregistrer** dans la barre en bas de l'écran. L'activation ou la désactivation de l'API est appliquée dès que vous enregistrez.
{% endstep %}
{% endstepper %}

L'application Incogniton doit être ouverte et connectée pour que l'API fonctionne. Lorsque vous fermez l'application, l'API s'arrête également.

### Changer le port de l'API

L'API écoute sur le port **35000** par défaut. Pour utiliser un autre port, entrez-le dans le champ **Port de l'API** et cliquez sur **Enregistrer**. Un nouveau numéro de port est utilisé la prochaine fois que vous démarrez Incogniton.

Si un autre programme utilise déjà le port, Incogniton affiche un message indiquant que le port est déjà utilisé et ne démarre pas l'API. Vous pouvez résoudre ce problème de deux manières :

* Entrez un port libre dans **Port de l'API**.
* Activez **Utiliser le port libre suivant si celui configuré est pris**. Incogniton choisit alors le port libre suivant. Pendant que l'API fonctionne, l'onglet affiche le port qu'elle utilise réellement : "L'API REST fonctionne actuellement sur le port …".

Le champ **Port Selenium** (par défaut 4444) définit le port de la grille Selenium qu'Incogniton exécute à côté de l'API pour les scripts Selenium.

### Qui peut accéder à l'API

L'API n'écoute que sur `127.0.0.1` (localhost). Les autres ordinateurs de votre réseau ne peuvent pas s'y connecter. Les sites web que vous visitez ne peuvent pas non plus envoyer de requêtes à travers votre navigateur. Les scripts, l'interface CLI et les SDK fonctionnant sur le même ordinateur fonctionnent normalement.

L'API fonctionne avec le compte connecté à l'application. Elle voit les mêmes profils que vous voyez dans l'application.

### Ce que vous pouvez faire avec l'API

Avec l'API, vous pouvez lister, créer, éditer, cloner et supprimer des profils, les lancer et les arrêter, lire et modifier leurs cookies, et lancer un profil pour Puppeteer, Playwright ou Selenium. Pour appeler un profil, vous avez besoin de son ID : développez le profil dans la liste des profils et cliquez sur **Copier** à côté de **ID du profil**.

Les points de terminaison, leurs paramètres et des exemples de requêtes se trouvent dans la documentation pour développeurs :

* [Démarrage rapide](https://api-docs.incogniton.com/getting-started/quickstart) : votre premier appel en quelques minutes.
* [Référence API](https://api-docs.incogniton.com/apis) : chaque point de terminaison. Vous pouvez également l'ouvrir depuis le lien **Documentation API** sur l'onglet Automatisation.
* [Exemples d'automatisation](https://api-docs.incogniton.com/how-to-guides/automation-examples) : scripts Puppeteer, Playwright et Selenium prêts à l'emploi.

### Utiliser l'interface CLI ou un SDK à la place

Vous n'avez pas besoin d'écrire vous-même des appels HTTP :

* **Interface CLI d'Incogniton** : exécutez les mêmes actions sous forme de commandes dans un terminal. Cliquez sur **Télécharger CLI** sur l'onglet Automatisation ; pendant qu'elle est installée, elle se met à jour automatiquement lorsque l'application démarre. Voir la [documentation CLI](https://api-docs.incogniton.com/cli).
* [**SDK JavaScript et Python**](https://docs.incogniton.com/documentation/french-documentation/api-dautomation-et-sdks/javascript-and-python-sdk.md) : appelez l'API depuis le code.
* [**Connecter des clients AI (MCP)**](https://docs.incogniton.com/documentation/french-documentation/api-dautomation-et-sdks/connect-ai-clients-mcp.md) : laissez un client AI tel que Claude ou Cursor gérer vos profils.
