> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/unigetui/fr/reference/ipc-api.md).

# API d'automatisation (IPC)

L'API HTTP locale qui alimente la ligne de commande de UniGetUI, soit les transports, l'authentification, les corps de requête et chaque point de terminaison.

UniGetUI expose une API HTTP locale que l'[interface de ligne de commande](/unigetui/fr/reference/cli.md) utilise pour contrôler une session. Vous pouvez l'appeler directement afin d'intégrer UniGetUI à vos propres scripts et outils. Chaque point de terminaison se trouve sous `/uniget/v1/`, et chacun a un équivalent CLI.

{% hint style="danger" %}
L'API est conçue pour l'automatisation locale seulement. Ne l'exposez pas au réseau.
{% endhint %}

## Transports

<table><thead><tr><th width="250">PARAMÈTRE</th><th>VALEUR PAR DÉFAUT</th></tr></thead><tbody><tr><td>Transport</td><td><code>named-pipe</code> : un canal nommé Windows sous Windows, une socket de domaine Unix sous macOS et Linux.</td></tr><tr><td>Transport de remplacement</td><td><code>tcp</code>, limité à <code>localhost</code> seulement.</td></tr><tr><td>Port TCP</td><td><code>7058</code></td></tr><tr><td>Nom du canal</td><td><code>UniGetUI.IPC</code></td></tr><tr><td>Dossier de la socket Unix (macOS, Linux)</td><td><code>/tmp</code></td></tr></tbody></table>

Sous macOS et Linux, un nom de canal relatif tel que `UniGetUI.IPC` est résolu en `/tmp/UniGetUI.IPC`, et un chemin absolu est utilisé tel quel. Sous Windows, les chemins de canal absolus sont rejetés et le nom de canal par défaut est utilisé.

{% hint style="info" %}
Dans une session de bureau, l'API ne fonctionne que lorsque ***Activer l'API en arrière-plan (Widgets et Partage UniGetUI, port 7058)*** est activé dans ***Paramètres*** – ***Paramètres expérimentaux et options pour les développeurs***. Une session démarrée avec `--headless` l'exécute toujours.
{% endhint %}

### Configuration du serveur

Lu lorsque UniGetUI démarre l'API.

<table><thead><tr><th width="250">ARGUMENT</th><th>VARIABLE D'ENVIRONNEMENT</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>--ipc-api-transport {named-pipe|tcp}</code></td><td><code>UNIGETUI_IPC_API_TRANSPORT</code></td><td>Transport de l'API.</td></tr><tr><td><code>--ipc-api-port &#x3C;port></code></td><td><code>UNIGETUI_IPC_API_PORT</code></td><td>Port TCP, avec le transport <code>tcp</code>.</td></tr><tr><td><code>--ipc-api-pipe-name &#x3C;name-or-path></code></td><td><code>UNIGETUI_IPC_API_PIPE_NAME</code></td><td>Nom du canal ou chemin de la socket Unix, avec le transport <code>named-pipe</code>.</td></tr></tbody></table>

### Configuration du client

Lu par la CLI pour trouver la session.

<table><thead><tr><th width="250">ARGUMENT</th><th>VARIABLE D'ENVIRONNEMENT</th><th>RÔLE</th></tr></thead><tbody><tr><td><code>--transport {named-pipe|tcp}</code></td><td><code>UNIGETUI_IPC_API_TRANSPORT</code></td><td>Transport utilisé pour atteindre la session.</td></tr><tr><td><code>--tcp-port &#x3C;port></code></td><td><code>UNIGETUI_IPC_API_PORT</code></td><td>Port TCP de la session.</td></tr><tr><td><code>--pipe-name &#x3C;name-or-path></code></td><td><code>UNIGETUI_IPC_API_PIPE_NAME</code></td><td>Nom du canal ou chemin de la socket Unix de la session.</td></tr></tbody></table>

## Découverte des sessions

Chaque session enregistre son point de terminaison et son jeton dans le dossier de configuration de l'utilisateur. Sans option de transport, le client :

1. Charge les sessions enregistrées, d'abord les sessions sans interface, puis les plus récentes.
2. Se connecte à la première session active et utilise automatiquement son jeton.

Avec une option de transport, le client se connecte à ce transport et attend jusqu'à 5 secondes l'apparition d'un jeton correspondant.

## Authentification

<table><thead><tr><th width="250">POINT DE TERMINAISON</th><th>AUTHENTIFICATION</th></tr></thead><tbody><tr><td><code>GET /uniget/v1/status</code></td><td>Aucun.</td></tr><tr><td>Tous les autres points de terminaison</td><td>Paramètre de requête <code>token</code>.</td></tr></tbody></table>

UniGetUI génère un nouveau jeton à chaque démarrage de l'API et le stocke avec l'enregistrement de la session. La CLI l'ajoute automatiquement aux requêtes.

## Sécurité

* Le mode TCP n'écoute que sur `localhost`, et non sur toutes les interfaces réseau.
* Sous macOS et Linux, la socket Unix n'est lisible et modifiable que par son propriétaire (équivalent de `0600`).
* Sous Windows, le canal nommé ne crée pas de fichier sur le disque.

## Réponses et erreurs

<table><thead><tr><th width="250">CONDITION</th><th>RÉSULTAT</th></tr></thead><tbody><tr><td>Jeton absent ou non valide</td><td>HTTP <code>401</code>.</td></tr><tr><td>Arguments de requête ou de corps non valides</td><td>HTTP <code>400</code> avec un message en texte brut.</td></tr><tr><td>Succès</td><td>JSON avec des noms de propriétés en camelCase.</td></tr></tbody></table>

## Paramètres de la requête

La plupart des points de terminaison prennent des paramètres de requête. Ceux ci-dessous prennent plutôt un corps JSON dont les champs sont en camelCase.

### Corps de maintenance du gestionnaire

Utilisé par `/managers/maintenance/reload`, `/executable/set`, `/executable/clear` et `/action`.

<table><thead><tr><th width="250">CHAMP</th><th>TYPE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><code>managerName</code></td><td>string</td><td>Obligatoire. Identifiant du gestionnaire, par exemple <code>winget</code>.</td></tr><tr><td><code>action</code></td><td>string</td><td>Action de maintenance, pour <code>/action</code>.</td></tr><tr><td><code>path</code></td><td>string</td><td>Chemin personnalisé de l'exécutable, pour <code>/executable/set</code>.</td></tr><tr><td><code>confirm</code></td><td>boolean</td><td>Confirme une action destructive.</td></tr></tbody></table>

### Corps de connexion à GitHub

<table><thead><tr><th width="250">CHAMP</th><th>TYPE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><code>launchBrowser</code></td><td>boolean</td><td>Ouvre automatiquement l'URL de vérification dans le navigateur.</td></tr></tbody></table>

### Corps de la sauvegarde infonuagique

<table><thead><tr><th width="250">CHAMP</th><th>TYPE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><code>key</code></td><td>string</td><td>Identifiant de la sauvegarde.</td></tr><tr><td><code>append</code></td><td>boolean</td><td>Ajoute au lot actuel au lieu de le remplacer.</td></tr></tbody></table>

### Corps d'importation du lot

<table><thead><tr><th width="250">CHAMP</th><th>TYPE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><code>path</code></td><td>string</td><td>Chemin du fichier de lot.</td></tr><tr><td><code>content</code></td><td>string</td><td>Contenu brut du lot.</td></tr><tr><td><code>format</code></td><td>string</td><td><code>ubundle</code>, <code>json</code>, <code>yaml</code> ou <code>xml</code>.</td></tr><tr><td><code>append</code></td><td>boolean</td><td>Ajoute les paquets importés au lot actuel.</td></tr></tbody></table>

### Corps d'exportation du lot

<table><thead><tr><th width="250">CHAMP</th><th>TYPE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><code>path</code></td><td>string</td><td>Chemin facultatif du fichier de sortie.</td></tr></tbody></table>

### Corps du paquet du lot

<table><thead><tr><th width="250">CHAMP</th><th>TYPE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><code>packageId</code></td><td>string</td><td>Identifiant du paquet.</td></tr><tr><td><code>managerName</code></td><td>string</td><td>Identifiant du gestionnaire.</td></tr><tr><td><code>packageSource</code></td><td>string</td><td>Nom de la source.</td></tr><tr><td><code>version</code></td><td>string</td><td>Version demandée.</td></tr><tr><td><code>scope</code></td><td>string</td><td>Portée demandée.</td></tr><tr><td><code>preRelease</code></td><td>boolean</td><td>Inclut les préversions.</td></tr><tr><td><code>selection</code></td><td>string</td><td>Façon dont le paquet est trouvé : <code>search</code>, <code>installed</code>, <code>updates</code> ou <code>auto</code>.</td></tr></tbody></table>

### Corps d'installation du lot

<table><thead><tr><th width="250">CHAMP</th><th>TYPE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><code>includeInstalled</code></td><td>boolean</td><td>Traite aussi les paquets déjà installés.</td></tr><tr><td><code>elevated</code></td><td>boolean</td><td>S'exécute avec des droits d'administrateur.</td></tr><tr><td><code>interactive</code></td><td>boolean</td><td>Lance les installateurs en mode interactif.</td></tr><tr><td><code>skipHash</code></td><td>boolean</td><td>Ignore la vérification du hachage lorsqu'elle est prise en charge.</td></tr></tbody></table>

### Paramètres de requête du paquet

Utilisé par les points de terminaison de paquet (détails, versions, installation, mise à jour, désinstallation, téléchargement, mises à jour ignorées).

<table><thead><tr><th width="250">PARAMÈTRE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><code>packageId</code></td><td>Identifiant du paquet.</td></tr><tr><td><code>manager</code></td><td>Identifiant du gestionnaire.</td></tr><tr><td><code>packageSource</code></td><td>Nom de la source.</td></tr><tr><td><code>version</code></td><td>Version demandée.</td></tr><tr><td><code>scope</code></td><td>Portée d'installation.</td></tr><tr><td><code>preRelease</code></td><td>Booléen. Inclut les préversions.</td></tr><tr><td><code>elevated</code></td><td>Booléen. S'exécute avec des droits d'administrateur.</td></tr><tr><td><code>interactive</code></td><td>Booléen. Lance l'installateur en mode interactif.</td></tr><tr><td><code>skipHash</code></td><td>Booléen. Ignore la vérification du hachage.</td></tr><tr><td><code>removeData</code></td><td>Booléen. Supprime les données du paquet lors de la désinstallation.</td></tr><tr><td><code>wait</code></td><td>Booléen. Attend la fin de l'opération.</td></tr><tr><td><code>architecture</code></td><td>Architecture à installer.</td></tr><tr><td><code>location</code></td><td>Dossier d'installation.</td></tr><tr><td><code>outputPath</code></td><td>Dossier de téléchargement. Par défaut, l'emplacement de téléchargement défini dans les paramètres, ou le dossier Téléchargements de l'utilisateur.</td></tr></tbody></table>

### Autres paramètres de requête

<table><thead><tr><th width="250">PARAMÈTRE</th><th>UTILISÉ PAR</th></tr></thead><tbody><tr><td><code>page</code>, <code>manager</code>, <code>helpAttachment</code></td><td><code>/app/navigate</code></td></tr><tr><td><code>tailLines</code></td><td><code>/operations/{operationId}/output</code></td></tr><tr><td><code>mode</code></td><td><code>/operations/{operationId}/retry</code></td></tr><tr><td><code>action</code></td><td><code>/operations/{operationId}/reorder</code></td></tr></tbody></table>

## Points de terminaison

Les chemins sont relatifs à `/uniget/v1`. Tous, sauf `/status`, exigent le paramètre de requête `token`.

### Session et application

<table><thead><tr><th width="250">MÉTHODE</th><th>CHEMIN</th><th>PARAMÈTRES</th><th>ÉQUIVALENT CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/status</code></td><td>Aucun</td><td><code>status</code>, <code>version</code>. Retourne <code>running</code>, <code>transport</code>, <code>tcpPort</code>, <code>namedPipeName</code>, <code>namedPipePath</code>, <code>baseAddress</code>, <code>version</code>, <code>buildNumber</code>.</td></tr><tr><td><code>GET</code></td><td><code>/app</code></td><td>Aucun</td><td><code>app status</code></td></tr><tr><td><code>POST</code></td><td><code>/app/show</code></td><td>Aucun</td><td><code>app show</code></td></tr><tr><td><code>POST</code></td><td><code>/app/navigate</code></td><td>Requête : <code>page</code>, facultatif <code>manager</code>, <code>helpAttachment</code></td><td><code>app navigate</code></td></tr><tr><td><code>POST</code></td><td><code>/app/quit</code></td><td>Aucun</td><td><code>app quit</code></td></tr></tbody></table>

### Opérations

<table><thead><tr><th width="250">MÉTHODE</th><th>CHEMIN</th><th>PARAMÈTRES</th><th>ÉQUIVALENT CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/operations</code></td><td>Aucun</td><td><code>operation list</code></td></tr><tr><td><code>GET</code></td><td><code>/operations/{operationId}</code></td><td>Route : <code>operationId</code></td><td><code>operation get</code></td></tr><tr><td><code>GET</code></td><td><code>/operations/{operationId}/output</code></td><td>Route : <code>operationId</code>, requête facultative <code>tailLines</code></td><td><code>operation output</code></td></tr><tr><td><code>POST</code></td><td><code>/operations/{operationId}/cancel</code></td><td>Route : <code>operationId</code></td><td><code>operation cancel</code></td></tr><tr><td><code>POST</code></td><td><code>/operations/{operationId}/retry</code></td><td>Route : <code>operationId</code>, requête facultative <code>mode</code></td><td><code>operation retry</code></td></tr><tr><td><code>POST</code></td><td><code>/operations/{operationId}/reorder</code></td><td>Route : <code>operationId</code>, requête <code>action</code></td><td><code>operation reorder</code></td></tr><tr><td><code>POST</code></td><td><code>/operations/{operationId}/forget</code></td><td>Route : <code>operationId</code></td><td><code>operation forget</code></td></tr></tbody></table>

### Gestionnaires de paquets

<table><thead><tr><th width="250">MÉTHODE</th><th>CHEMIN</th><th>PARAMÈTRES</th><th>ÉQUIVALENT CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/managers</code></td><td>Aucun</td><td><code>manager list</code></td></tr><tr><td><code>GET</code></td><td><code>/managers/maintenance</code></td><td>Requête : <code>manager</code></td><td><code>manager maintenance</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/maintenance/reload</code></td><td>Corps de maintenance du gestionnaire</td><td><code>manager reload</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/maintenance/executable/set</code></td><td>Corps de maintenance du gestionnaire</td><td><code>manager set-executable</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/maintenance/executable/clear</code></td><td>Corps de maintenance du gestionnaire</td><td><code>manager clear-executable</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/maintenance/action</code></td><td>Corps de maintenance du gestionnaire</td><td><code>manager action</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/set-enabled</code></td><td>Requête : <code>manager</code>, <code>enabled</code></td><td><code>manager enable</code>, <code>manager disable</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/set-update-notifications</code></td><td>Requête : <code>manager</code>, <code>enabled</code></td><td><code>manager notifications enable</code>, <code>manager notifications disable</code></td></tr></tbody></table>

### Sources

<table><thead><tr><th width="250">MÉTHODE</th><th>CHEMIN</th><th>PARAMÈTRES</th><th>ÉQUIVALENT CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/sources</code></td><td>Requête facultative : <code>manager</code></td><td><code>source list</code></td></tr><tr><td><code>POST</code></td><td><code>/sources/add</code></td><td>Requête : <code>manager</code>, <code>name</code>, facultatif <code>url</code></td><td><code>source add</code></td></tr><tr><td><code>POST</code></td><td><code>/sources/remove</code></td><td>Requête : <code>manager</code>, <code>name</code>, facultatif <code>url</code></td><td><code>source remove</code></td></tr></tbody></table>

### Paramètres

<table><thead><tr><th width="250">MÉTHODE</th><th>CHEMIN</th><th>PARAMÈTRES</th><th>ÉQUIVALENT CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/settings</code></td><td>Aucun</td><td><code>settings list</code></td></tr><tr><td><code>GET</code></td><td><code>/settings/item</code></td><td>Requête : <code>key</code></td><td><code>settings get</code></td></tr><tr><td><code>POST</code></td><td><code>/settings/set</code></td><td>Requête : <code>key</code>, facultatif <code>enabled</code>, facultatif <code>value</code></td><td><code>settings set</code></td></tr><tr><td><code>POST</code></td><td><code>/settings/clear</code></td><td>Requête : <code>key</code></td><td><code>settings clear</code></td></tr><tr><td><code>POST</code></td><td><code>/settings/reset</code></td><td>Aucun</td><td><code>settings reset</code></td></tr><tr><td><code>GET</code></td><td><code>/secure-settings</code></td><td>Requête facultative : <code>user</code></td><td><code>settings secure list</code></td></tr><tr><td><code>GET</code></td><td><code>/secure-settings/item</code></td><td>Requête : <code>key</code>, facultatif <code>user</code></td><td><code>settings secure get</code></td></tr><tr><td><code>POST</code></td><td><code>/secure-settings/set</code></td><td>Requête : <code>key</code>, <code>enabled</code>, facultatif <code>user</code></td><td><code>settings secure set</code></td></tr></tbody></table>

### Raccourcis

Les points de terminaison du menu Démarrer sont réservés à Windows. Les règles de chemin et de paquet sont décrites dans la référence CLI sous [Raccourcis du menu Démarrer](/unigetui/fr/reference/cli.md#start-menu-shortcuts) et [Dossiers du menu Démarrer](/unigetui/fr/reference/cli.md#start-menu-folders). La réponse de `/start-menu-folders/set` énumère les raccourcis correspondants dans `matchingShortcuts`.

<table><thead><tr><th width="250">MÉTHODE</th><th>CHEMIN</th><th>PARAMÈTRES</th><th>ÉQUIVALENT CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/desktop-shortcuts</code></td><td>Aucun</td><td><code>shortcut list</code></td></tr><tr><td><code>POST</code></td><td><code>/desktop-shortcuts/set</code></td><td>Requête : <code>path</code>, <code>status</code></td><td><code>shortcut set</code></td></tr><tr><td><code>POST</code></td><td><code>/desktop-shortcuts/reset</code></td><td>Requête : <code>path</code></td><td><code>shortcut reset</code></td></tr><tr><td><code>POST</code></td><td><code>/desktop-shortcuts/reset-all</code></td><td>Aucun</td><td><code>shortcut reset-all</code></td></tr><tr><td><code>GET</code></td><td><code>/start-menu-shortcuts</code></td><td>Aucun</td><td><code>start-menu shortcut list</code></td></tr><tr><td><code>POST</code></td><td><code>/start-menu-shortcuts/set</code></td><td>Requête : <code>path</code>, <code>status</code></td><td><code>start-menu shortcut set</code></td></tr><tr><td><code>POST</code></td><td><code>/start-menu-shortcuts/reset</code></td><td>Requête : <code>path</code></td><td><code>start-menu shortcut reset</code></td></tr><tr><td><code>POST</code></td><td><code>/start-menu-shortcuts/reset-all</code></td><td>Aucun</td><td><code>start-menu shortcut reset-all</code></td></tr><tr><td><code>GET</code></td><td><code>/start-menu-folders</code></td><td>Aucun</td><td><code>start-menu folder list</code></td></tr><tr><td><code>POST</code></td><td><code>/start-menu-folders/set</code></td><td>Requête : <code>package</code>, <code>folder</code>, facultatif <code>relocate-existing</code></td><td><code>start-menu folder set</code></td></tr><tr><td><code>POST</code></td><td><code>/start-menu-folders/remove</code></td><td>Requête : <code>package</code></td><td><code>start-menu folder remove</code></td></tr></tbody></table>

### Journaux

<table><thead><tr><th width="250">MÉTHODE</th><th>CHEMIN</th><th>PARAMÈTRES</th><th>ÉQUIVALENT CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/logs/app</code></td><td>Requête facultative : <code>level</code></td><td><code>log app</code></td></tr><tr><td><code>GET</code></td><td><code>/logs/history</code></td><td>Aucun</td><td><code>log operations</code></td></tr><tr><td><code>GET</code></td><td><code>/logs/manager</code></td><td>Requête facultative : <code>manager</code>, <code>verbose</code></td><td><code>log manager</code></td></tr></tbody></table>

### Sauvegardes

<table><thead><tr><th width="250">MÉTHODE</th><th>CHEMIN</th><th>PARAMÈTRES</th><th>ÉQUIVALENT CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/backups/status</code></td><td>Aucun</td><td><code>backup status</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/local/create</code></td><td>Aucun</td><td><code>backup local create</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/github/sign-in/start</code></td><td>Corps de connexion à GitHub</td><td><code>backup github login start</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/github/sign-in/complete</code></td><td>Aucun</td><td><code>backup github login complete</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/github/sign-out</code></td><td>Aucun</td><td><code>backup github logout</code></td></tr><tr><td><code>GET</code></td><td><code>/backups/cloud</code></td><td>Aucun</td><td><code>backup cloud list</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/cloud/create</code></td><td>Aucun</td><td><code>backup cloud create</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/cloud/download</code></td><td>Corps de la sauvegarde infonuagique</td><td><code>backup cloud download</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/cloud/restore</code></td><td>Corps de la sauvegarde infonuagique</td><td><code>backup cloud restore</code></td></tr></tbody></table>

### Lots

<table><thead><tr><th width="250">MÉTHODE</th><th>CHEMIN</th><th>PARAMÈTRES</th><th>ÉQUIVALENT CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/bundles</code></td><td>Aucun</td><td><code>bundle get</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/reset</code></td><td>Aucun</td><td><code>bundle reset</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/import</code></td><td>Corps d'importation du lot</td><td><code>bundle import</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/export</code></td><td>Corps d'exportation du lot</td><td><code>bundle export</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/add</code></td><td>Corps du paquet du lot</td><td><code>bundle add</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/remove</code></td><td>Corps du paquet du lot</td><td><code>bundle remove</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/install</code></td><td>Corps d'installation du lot</td><td><code>bundle install</code></td></tr></tbody></table>

### Paquets

<table><thead><tr><th width="250">MÉTHODE</th><th>CHEMIN</th><th>PARAMÈTRES</th><th>ÉQUIVALENT CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/packages/search</code></td><td>Requête : <code>query</code>, facultatif <code>manager</code>, <code>maxResults</code></td><td><code>package search</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/installed</code></td><td>Requête facultative : <code>manager</code></td><td><code>package installed</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/updates</code></td><td>Requête facultative : <code>manager</code></td><td><code>package updates</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/details</code></td><td>Paramètres de requête du paquet</td><td><code>package details</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/versions</code></td><td>Paramètres de requête du paquet</td><td><code>package versions</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/ignored</code></td><td>Aucun</td><td><code>package ignored list</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/ignore</code></td><td>Paramètres de requête du paquet</td><td><code>package ignored add</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/unignore</code></td><td>Paramètres de requête du paquet</td><td><code>package ignored remove</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/download</code></td><td>Paramètres de requête du paquet</td><td><code>package download</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/install</code></td><td>Paramètres de requête du paquet</td><td><code>package install</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/reinstall</code></td><td>Paramètres de requête du paquet</td><td><code>package reinstall</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/update</code></td><td>Paramètres de requête du paquet</td><td><code>package update</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/uninstall</code></td><td>Paramètres de requête du paquet</td><td><code>package uninstall</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/uninstall-then-reinstall</code></td><td>Paramètres de requête du paquet</td><td><code>package repair</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/show</code></td><td>Requête : <code>packageId</code>, <code>packageSource</code></td><td><code>package show</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/update-all</code></td><td>Aucun</td><td><code>package update-all</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/update-manager</code></td><td>Requête : <code>manager</code></td><td><code>package update-manager</code></td></tr></tbody></table>

## Limites du mode sans interface

Dans une session sans interface, ces points de terminaison renvoient HTTP `400` avec un message descriptif :

* `POST /uniget/v1/app/show` et `POST /uniget/v1/app/navigate` : il n'y a aucune fenêtre.
* `POST /uniget/v1/packages/update-all` et `POST /uniget/v1/packages/update-manager` : sauf si l'hôte fournit les gestionnaires qui lancent ces mises à jour.

## Essayer avec curl

Démarrez une session sans interface en mode TCP :

```powershell
UniGetUI.exe --headless --ipc-api-transport tcp --ipc-api-port 7058
```

Interrogez ensuite le point de terminaison d'état, qui n'exige aucun jeton :

```powershell
curl http://localhost:7058/uniget/v1/status
```

Les autres points de terminaison exigent le jeton de session dans le paramètre de requête `token`. La CLI s'en occupe pour vous.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/unigetui/fr/reference/ipc-api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.