> 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/es/referencia/ipc-api.md).

# API de automatización (IPC)

La API HTTP local que sustenta la línea de comandos de UniGetUI, con los transportes, la autenticación, los cuerpos de solicitud y cada punto de conexión.

UniGetUI expone una API HTTP local que la [interfaz de línea de comandos](/unigetui/es/referencia/cli.md) usa para controlar una sesión. Puede llamarla directamente para integrar UniGetUI con sus propios scripts y herramientas. Cada punto de conexión está bajo `/uniget/v1/`, y cada uno tiene un equivalente de CLI.

{% hint style="danger" %}
La API está pensada solo para la automatización local. No la exponga a la red.
{% endhint %}

## Transportes

<table><thead><tr><th width="250">CONFIGURACIÓN</th><th>PREDETERMINADO</th></tr></thead><tbody><tr><td>Transporte</td><td><code>named-pipe</code>: una canalización con nombre de Windows en Windows, un socket de dominio Unix en macOS y Linux.</td></tr><tr><td>Transporte alternativo</td><td><code>tcp</code>, enlazado únicamente a <code>localhost</code>.</td></tr><tr><td>Puerto TCP</td><td><code>7058</code></td></tr><tr><td>Nombre de la canalización</td><td><code>UniGetUI.IPC</code></td></tr><tr><td>Carpeta del socket Unix (macOS, Linux)</td><td><code>/tmp</code></td></tr></tbody></table>

En macOS y Linux, un nombre de canalización relativo como `UniGetUI.IPC` se resuelve en `/tmp/UniGetUI.IPC`, y una ruta absoluta se usa tal cual. En Windows, las rutas de canalización absolutas se rechazan y se usa el nombre de canalización predeterminado.

{% hint style="info" %}
En una sesión de escritorio, la API solo se ejecuta cuando ***Habilitar API en segundo plano (Widgets de UniGetUI y Compartir, puerto 7058)*** está activado en ***Configuración*** – ***Ajustes experimentales y opciones de desarrollador***. Una sesión iniciada con `--headless` siempre la ejecuta.
{% endhint %}

### Configuración del servidor

Se lee cuando UniGetUI inicia la API.

<table><thead><tr><th width="250">ARGUMENTO</th><th>VARIABLE DE ENTORNO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>--ipc-api-transport {named-pipe|tcp}</code></td><td><code>UNIGETUI_IPC_API_TRANSPORT</code></td><td>Transporte de la API.</td></tr><tr><td><code>--ipc-api-port &#x3C;port></code></td><td><code>UNIGETUI_IPC_API_PORT</code></td><td>Puerto TCP, con el transporte <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>Nombre de la canalización o ruta del socket Unix, con el transporte <code>named-pipe</code>.</td></tr></tbody></table>

### Configuración del cliente

La CLI lo lee para encontrar la sesión.

<table><thead><tr><th width="250">ARGUMENTO</th><th>VARIABLE DE ENTORNO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>--transport {named-pipe|tcp}</code></td><td><code>UNIGETUI_IPC_API_TRANSPORT</code></td><td>Transporte usado para llegar a la sesión.</td></tr><tr><td><code>--tcp-port &#x3C;port></code></td><td><code>UNIGETUI_IPC_API_PORT</code></td><td>Puerto TCP de la sesión.</td></tr><tr><td><code>--pipe-name &#x3C;name-or-path></code></td><td><code>UNIGETUI_IPC_API_PIPE_NAME</code></td><td>Nombre de la canalización o ruta del socket Unix de la sesión.</td></tr></tbody></table>

## Descubrimiento de sesiones

Cada sesión registra su punto de conexión y su token en la carpeta de configuración del usuario. Sin una opción de transporte, el cliente:

1. Carga las sesiones registradas, primero las sesiones sin interfaz y luego las más recientes.
2. Se conecta a la primera sesión activa y usa su token automáticamente.

Con una opción de transporte, el cliente se conecta a ese transporte y espera hasta 5 segundos a que aparezca un token coincidente.

## Autenticación

<table><thead><tr><th width="250">PUNTO DE CONEXIÓN</th><th>AUTENTICACIÓN</th></tr></thead><tbody><tr><td><code>GET /uniget/v1/status</code></td><td>Ninguno.</td></tr><tr><td>Todos los demás puntos de conexión</td><td>Parámetro de consulta <code>token</code>.</td></tr></tbody></table>

UniGetUI genera un token nuevo cada vez que se inicia la API y lo guarda con el registro de la sesión. La CLI lo añade automáticamente a las solicitudes.

## Seguridad

* El modo TCP escucha solo en `localhost`, no en todas las interfaces de red.
* En macOS y Linux, el socket Unix solo lo puede leer y escribir su propietario (equivalente a `0600`).
* En Windows, la canalización con nombre no crea ningún archivo en el disco.

## Respuestas y errores

<table><thead><tr><th width="250">CONDICIÓN</th><th>RESULTADO</th></tr></thead><tbody><tr><td>Token ausente o no válido</td><td>HTTP <code>401</code>.</td></tr><tr><td>Argumentos de consulta o del cuerpo no válidos</td><td>HTTP <code>400</code> con un mensaje de texto sin formato.</td></tr><tr><td>Éxito</td><td>JSON con nombres de propiedad en camelCase.</td></tr></tbody></table>

## Parámetros de la solicitud

La mayoría de los puntos de conexión aceptan parámetros de consulta. Los siguientes aceptan en su lugar un cuerpo JSON con campos en camelCase.

### Cuerpo de mantenimiento del gestor

Usado por `/managers/maintenance/reload`, `/executable/set`, `/executable/clear` y `/action`.

<table><thead><tr><th width="250">CAMPO</th><th>TIPO</th><th>DESCRIPCIÓN</th></tr></thead><tbody><tr><td><code>managerName</code></td><td>string</td><td>Obligatorio. Identificador del gestor, como <code>winget</code>.</td></tr><tr><td><code>action</code></td><td>string</td><td>Acción de mantenimiento, para <code>/action</code>.</td></tr><tr><td><code>path</code></td><td>string</td><td>Ruta personalizada del ejecutable, para <code>/executable/set</code>.</td></tr><tr><td><code>confirm</code></td><td>boolean</td><td>Confirma una acción destructiva.</td></tr></tbody></table>

### Cuerpo de inicio de sesión en GitHub

<table><thead><tr><th width="250">CAMPO</th><th>TIPO</th><th>DESCRIPCIÓN</th></tr></thead><tbody><tr><td><code>launchBrowser</code></td><td>boolean</td><td>Abre automáticamente la URL de verificación en el navegador.</td></tr></tbody></table>

### Cuerpo de la copia de seguridad en la nube

<table><thead><tr><th width="250">CAMPO</th><th>TIPO</th><th>DESCRIPCIÓN</th></tr></thead><tbody><tr><td><code>key</code></td><td>string</td><td>Identificador de la copia de seguridad.</td></tr><tr><td><code>append</code></td><td>boolean</td><td>Añade al lote actual en lugar de sustituirlo.</td></tr></tbody></table>

### Cuerpo de importación del lote

<table><thead><tr><th width="250">CAMPO</th><th>TIPO</th><th>DESCRIPCIÓN</th></tr></thead><tbody><tr><td><code>path</code></td><td>string</td><td>Ruta del archivo del lote.</td></tr><tr><td><code>content</code></td><td>string</td><td>Contenido sin procesar del lote.</td></tr><tr><td><code>format</code></td><td>string</td><td><code>ubundle</code>, <code>json</code>, <code>yaml</code> o <code>xml</code>.</td></tr><tr><td><code>append</code></td><td>boolean</td><td>Añade los paquetes importados al lote actual.</td></tr></tbody></table>

### Cuerpo de exportación del lote

<table><thead><tr><th width="250">CAMPO</th><th>TIPO</th><th>DESCRIPCIÓN</th></tr></thead><tbody><tr><td><code>path</code></td><td>string</td><td>Ruta opcional del archivo de salida.</td></tr></tbody></table>

### Cuerpo del paquete del lote

<table><thead><tr><th width="250">CAMPO</th><th>TIPO</th><th>DESCRIPCIÓN</th></tr></thead><tbody><tr><td><code>packageId</code></td><td>string</td><td>Identificador del paquete.</td></tr><tr><td><code>managerName</code></td><td>string</td><td>Identificador del gestor.</td></tr><tr><td><code>packageSource</code></td><td>string</td><td>Nombre del origen.</td></tr><tr><td><code>version</code></td><td>string</td><td>Versión solicitada.</td></tr><tr><td><code>scope</code></td><td>string</td><td>Ámbito solicitado.</td></tr><tr><td><code>preRelease</code></td><td>boolean</td><td>Incluye las versiones preliminares.</td></tr><tr><td><code>selection</code></td><td>string</td><td>Cómo se encuentra el paquete: <code>search</code>, <code>installed</code>, <code>updates</code> o <code>auto</code>.</td></tr></tbody></table>

### Cuerpo de instalación del lote

<table><thead><tr><th width="250">CAMPO</th><th>TIPO</th><th>DESCRIPCIÓN</th></tr></thead><tbody><tr><td><code>includeInstalled</code></td><td>boolean</td><td>Procesa también los paquetes ya instalados.</td></tr><tr><td><code>elevated</code></td><td>boolean</td><td>Se ejecuta con derechos de administrador.</td></tr><tr><td><code>interactive</code></td><td>boolean</td><td>Ejecuta los instaladores de forma interactiva.</td></tr><tr><td><code>skipHash</code></td><td>boolean</td><td>Omite la comprobación del hash cuando se admite.</td></tr></tbody></table>

### Parámetros de consulta del paquete

Lo usan los puntos de conexión de paquetes (detalles, versiones, instalación, actualización, desinstalación, descarga, actualizaciones ignoradas).

<table><thead><tr><th width="250">PARÁMETRO</th><th>DESCRIPCIÓN</th></tr></thead><tbody><tr><td><code>packageId</code></td><td>Identificador del paquete.</td></tr><tr><td><code>manager</code></td><td>Identificador del gestor.</td></tr><tr><td><code>packageSource</code></td><td>Nombre del origen.</td></tr><tr><td><code>version</code></td><td>Versión solicitada.</td></tr><tr><td><code>scope</code></td><td>Ámbito de instalación.</td></tr><tr><td><code>preRelease</code></td><td>Booleano. Incluye las versiones preliminares.</td></tr><tr><td><code>elevated</code></td><td>Booleano. Se ejecuta con derechos de administrador.</td></tr><tr><td><code>interactive</code></td><td>Booleano. Ejecuta el instalador de forma interactiva.</td></tr><tr><td><code>skipHash</code></td><td>Booleano. Omite la comprobación del hash.</td></tr><tr><td><code>removeData</code></td><td>Booleano. Quita los datos del paquete al desinstalar.</td></tr><tr><td><code>wait</code></td><td>Booleano. Espera a que finalice la operación.</td></tr><tr><td><code>architecture</code></td><td>Arquitectura que se instalará.</td></tr><tr><td><code>location</code></td><td>Carpeta de instalación.</td></tr><tr><td><code>outputPath</code></td><td>Carpeta de descarga. De forma predeterminada, la ubicación de descarga establecida en la configuración o la carpeta Descargas del usuario.</td></tr></tbody></table>

### Otros parámetros de consulta

<table><thead><tr><th width="250">PARÁMETRO</th><th>USADO POR</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>

## Puntos de conexión

Las rutas son relativas a `/uniget/v1`. Todos, excepto `/status`, necesitan el parámetro de consulta `token`.

### Sesión y aplicación

<table><thead><tr><th width="250">MÉTODO</th><th>RUTA</th><th>PARÁMETROS</th><th>EQUIVALENTE DE LA CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/status</code></td><td>Ninguno</td><td><code>status</code>, <code>version</code>. Devuelve <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>Ninguno</td><td><code>app status</code></td></tr><tr><td><code>POST</code></td><td><code>/app/show</code></td><td>Ninguno</td><td><code>app show</code></td></tr><tr><td><code>POST</code></td><td><code>/app/navigate</code></td><td>Consulta: <code>page</code>, opcional <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>Ninguno</td><td><code>app quit</code></td></tr></tbody></table>

### Operaciones

<table><thead><tr><th width="250">MÉTODO</th><th>RUTA</th><th>PARÁMETROS</th><th>EQUIVALENTE DE LA CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/operations</code></td><td>Ninguno</td><td><code>operation list</code></td></tr><tr><td><code>GET</code></td><td><code>/operations/{operationId}</code></td><td>Ruta: <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>Ruta: <code>operationId</code>, consulta opcional <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>Ruta: <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>Ruta: <code>operationId</code>, consulta opcional <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>Ruta: <code>operationId</code>, consulta <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>Ruta: <code>operationId</code></td><td><code>operation forget</code></td></tr></tbody></table>

### Gestores de paquetes

<table><thead><tr><th width="250">MÉTODO</th><th>RUTA</th><th>PARÁMETROS</th><th>EQUIVALENTE DE LA CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/managers</code></td><td>Ninguno</td><td><code>manager list</code></td></tr><tr><td><code>GET</code></td><td><code>/managers/maintenance</code></td><td>Consulta: <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>Cuerpo de mantenimiento del gestor</td><td><code>manager reload</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/maintenance/executable/set</code></td><td>Cuerpo de mantenimiento del gestor</td><td><code>manager set-executable</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/maintenance/executable/clear</code></td><td>Cuerpo de mantenimiento del gestor</td><td><code>manager clear-executable</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/maintenance/action</code></td><td>Cuerpo de mantenimiento del gestor</td><td><code>manager action</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/set-enabled</code></td><td>Consulta: <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>Consulta: <code>manager</code>, <code>enabled</code></td><td><code>manager notifications enable</code>, <code>manager notifications disable</code></td></tr></tbody></table>

### Fuentes

<table><thead><tr><th width="250">MÉTODO</th><th>RUTA</th><th>PARÁMETROS</th><th>EQUIVALENTE DE LA CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/sources</code></td><td>Consulta opcional: <code>manager</code></td><td><code>source list</code></td></tr><tr><td><code>POST</code></td><td><code>/sources/add</code></td><td>Consulta: <code>manager</code>, <code>name</code>, opcional <code>url</code></td><td><code>source add</code></td></tr><tr><td><code>POST</code></td><td><code>/sources/remove</code></td><td>Consulta: <code>manager</code>, <code>name</code>, opcional <code>url</code></td><td><code>source remove</code></td></tr></tbody></table>

### Configuración

<table><thead><tr><th width="250">MÉTODO</th><th>RUTA</th><th>PARÁMETROS</th><th>EQUIVALENTE DE LA CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/settings</code></td><td>Ninguno</td><td><code>settings list</code></td></tr><tr><td><code>GET</code></td><td><code>/settings/item</code></td><td>Consulta: <code>key</code></td><td><code>settings get</code></td></tr><tr><td><code>POST</code></td><td><code>/settings/set</code></td><td>Consulta: <code>key</code>, opcional <code>enabled</code>, opcional <code>value</code></td><td><code>settings set</code></td></tr><tr><td><code>POST</code></td><td><code>/settings/clear</code></td><td>Consulta: <code>key</code></td><td><code>settings clear</code></td></tr><tr><td><code>POST</code></td><td><code>/settings/reset</code></td><td>Ninguno</td><td><code>settings reset</code></td></tr><tr><td><code>GET</code></td><td><code>/secure-settings</code></td><td>Consulta opcional: <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>Consulta: <code>key</code>, opcional <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>Consulta: <code>key</code>, <code>enabled</code>, opcional <code>user</code></td><td><code>settings secure set</code></td></tr></tbody></table>

### Accesos directos

Los puntos de conexión del menú Inicio son exclusivos de Windows. Las reglas de ruta y de paquete se describen en la referencia de la CLI, en [Accesos directos del menú Inicio](/unigetui/es/referencia/cli.md#start-menu-shortcuts) y [Carpetas del menú Inicio](/unigetui/es/referencia/cli.md#start-menu-folders). La respuesta de `/start-menu-folders/set` enumera los accesos directos coincidentes en `matchingShortcuts`.

<table><thead><tr><th width="250">MÉTODO</th><th>RUTA</th><th>PARÁMETROS</th><th>EQUIVALENTE DE LA CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/desktop-shortcuts</code></td><td>Ninguno</td><td><code>shortcut list</code></td></tr><tr><td><code>POST</code></td><td><code>/desktop-shortcuts/set</code></td><td>Consulta: <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>Consulta: <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>Ninguno</td><td><code>shortcut reset-all</code></td></tr><tr><td><code>GET</code></td><td><code>/start-menu-shortcuts</code></td><td>Ninguno</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>Consulta: <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>Consulta: <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>Ninguno</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>Ninguno</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>Consulta: <code>package</code>, <code>folder</code>, opcional <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>Consulta: <code>package</code></td><td><code>start-menu folder remove</code></td></tr></tbody></table>

### Registros

<table><thead><tr><th width="250">MÉTODO</th><th>RUTA</th><th>PARÁMETROS</th><th>EQUIVALENTE DE LA CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/logs/app</code></td><td>Consulta opcional: <code>level</code></td><td><code>log app</code></td></tr><tr><td><code>GET</code></td><td><code>/logs/history</code></td><td>Ninguno</td><td><code>log operations</code></td></tr><tr><td><code>GET</code></td><td><code>/logs/manager</code></td><td>Consulta opcional: <code>manager</code>, <code>verbose</code></td><td><code>log manager</code></td></tr></tbody></table>

### Copias de seguridad

<table><thead><tr><th width="250">MÉTODO</th><th>RUTA</th><th>PARÁMETROS</th><th>EQUIVALENTE DE LA CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/backups/status</code></td><td>Ninguno</td><td><code>backup status</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/local/create</code></td><td>Ninguno</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>Cuerpo de inicio de sesión en 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>Ninguno</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>Ninguno</td><td><code>backup github logout</code></td></tr><tr><td><code>GET</code></td><td><code>/backups/cloud</code></td><td>Ninguno</td><td><code>backup cloud list</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/cloud/create</code></td><td>Ninguno</td><td><code>backup cloud create</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/cloud/download</code></td><td>Cuerpo de la copia de seguridad en la nube</td><td><code>backup cloud download</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/cloud/restore</code></td><td>Cuerpo de la copia de seguridad en la nube</td><td><code>backup cloud restore</code></td></tr></tbody></table>

### Lotes

<table><thead><tr><th width="250">MÉTODO</th><th>RUTA</th><th>PARÁMETROS</th><th>EQUIVALENTE DE LA CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/bundles</code></td><td>Ninguno</td><td><code>bundle get</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/reset</code></td><td>Ninguno</td><td><code>bundle reset</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/import</code></td><td>Cuerpo de importación del lote</td><td><code>bundle import</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/export</code></td><td>Cuerpo de exportación del lote</td><td><code>bundle export</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/add</code></td><td>Cuerpo del paquete del lote</td><td><code>bundle add</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/remove</code></td><td>Cuerpo del paquete del lote</td><td><code>bundle remove</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/install</code></td><td>Cuerpo de instalación del lote</td><td><code>bundle install</code></td></tr></tbody></table>

### Paquetes

<table><thead><tr><th width="250">MÉTODO</th><th>RUTA</th><th>PARÁMETROS</th><th>EQUIVALENTE DE LA CLI</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/packages/search</code></td><td>Consulta: <code>query</code>, opcional <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>Consulta opcional: <code>manager</code></td><td><code>package installed</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/updates</code></td><td>Consulta opcional: <code>manager</code></td><td><code>package updates</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/details</code></td><td>Parámetros de consulta del paquete</td><td><code>package details</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/versions</code></td><td>Parámetros de consulta del paquete</td><td><code>package versions</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/ignored</code></td><td>Ninguno</td><td><code>package ignored list</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/ignore</code></td><td>Parámetros de consulta del paquete</td><td><code>package ignored add</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/unignore</code></td><td>Parámetros de consulta del paquete</td><td><code>package ignored remove</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/download</code></td><td>Parámetros de consulta del paquete</td><td><code>package download</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/install</code></td><td>Parámetros de consulta del paquete</td><td><code>package install</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/reinstall</code></td><td>Parámetros de consulta del paquete</td><td><code>package reinstall</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/update</code></td><td>Parámetros de consulta del paquete</td><td><code>package update</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/uninstall</code></td><td>Parámetros de consulta del paquete</td><td><code>package uninstall</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/uninstall-then-reinstall</code></td><td>Parámetros de consulta del paquete</td><td><code>package repair</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/show</code></td><td>Consulta: <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>Ninguno</td><td><code>package update-all</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/update-manager</code></td><td>Consulta: <code>manager</code></td><td><code>package update-manager</code></td></tr></tbody></table>

## Limitaciones del modo sin interfaz

En una sesión sin interfaz, estos puntos de conexión devuelven HTTP `400` con un mensaje descriptivo:

* `POST /uniget/v1/app/show` y `POST /uniget/v1/app/navigate`: no hay ninguna ventana.
* `POST /uniget/v1/packages/update-all` y `POST /uniget/v1/packages/update-manager`: salvo que el host proporcione los controladores que inician estas actualizaciones.

## Probar con curl

Inicie una sesión sin interfaz en modo TCP:

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

Después consulte el punto de conexión de estado, que no necesita ningún token:

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

Los demás puntos de conexión necesitan el token de la sesión en el parámetro de consulta `token`. La CLI lo resuelve por usted.


---

# 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/es/referencia/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.