> 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 Devolutions UniGetUI, con los transportes, la autenticación, los cuerpos de solicitud y cada punto de conexión.

Devolutions UniGetUI expone una API HTTP local que la [interfaz de línea de comandos](https://docs.devolutions.net/unigetui/es/referencia/cli.md) usa para controlar una sesión. Puede llamarla directamente para integrar Devolutions 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> (de 1 a 65535)</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. La ruta del socket resultante no puede superar los 104 caracteres. En Windows, las rutas de canalización absolutas se rechazan. Un transporte, un puerto o un nombre de canalización no válido se registra y se sustituye por el valor predeterminado. El transporte también acepta `pipe` y `namedpipe` para `named-pipe`.

La API habla HTTP/1.1 en todos los transportes. Con la canalización con nombre o el socket Unix, envíe las solicitudes a `http://localhost/`.

{% 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 Devolutions 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 lee la CLI para encontrar la sesión. La CLI también acepta los argumentos del servidor anteriores.

<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 un archivo JSON de la carpeta `IpcApiEndpoints`, en la carpeta de configuración de usuario de Devolutions UniGetUI, y lo quita cuando se detiene. Sin una opción de transporte ni una variable de entorno, 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 o una variable de entorno, 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>

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

## 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.
* En macOS y Linux, un archivo de socket residual en la ruta predeterminada se sustituye cuando la API se inicia. Si ya existe una ruta de socket absoluta explícita, la API no se inicia.

## 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, o una acción que la sesión no puede realizar</td><td>HTTP <code>400</code> con un mensaje de texto sin formato.</td></tr><tr><td>Entrada desconocida del historial de operaciones (<code>/logs/history/detail</code>)</td><td>HTTP <code>404</code>.</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 la acción. Lo exigen <code>repair-winget</code>, <code>install-scoop</code>, <code>uninstall-scoop</code> y <code>cleanup-scoop</code>.</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> (predeterminado), <code>json</code>, <code>yaml</code> (o <code>yml</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> (predeterminado), <code>installed</code>, <code>updates</code> (o <code>upgradable</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>Obligatorio. 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. Predeterminado: <code>true</code>.</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>: <code>retry</code>, <code>retry-as-admin</code>, <code>retry-interactive</code>, <code>retry-no-hash-check</code> o <code>retry-close-running-app</code></td></tr><tr><td><code>action</code></td><td><code>/operations/{operationId}/reorder</code>: <code>run-now</code>, <code>run-next</code> o <code>run-last</code></td></tr><tr><td><code>level</code></td><td><code>/logs/app</code>: de <code>1</code> a <code>5</code>, predeterminado <code>4</code></td></tr><tr><td><code>id</code></td><td><code>/logs/history/detail</code></td></tr><tr><td><code>maxResults</code></td><td><code>/packages/search</code>: predeterminado 50, hasta 500</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](https://docs.devolutions.net/unigetui/es/referencia/cli.md#start-menu-shortcuts) y [Carpetas del menú Inicio](https://docs.devolutions.net/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/history/detail</code></td><td>Consulta: <code>id</code></td><td>Ninguno. Devuelve una entrada del historial de operaciones, con su salida.</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

Una sesión sin interfaz carga los gestores de paquetes y se ejecuta hasta `POST /uniget/v1/app/quit` o <kbd>Ctrl</kbd>+<kbd>C</kbd>. Estos puntos de conexión devuelven HTTP `400` con un mensaje descriptivo allí:

* `POST /uniget/v1/app/show` y `POST /uniget/v1/app/navigate`: no hay ninguna ventana.
* `POST /uniget/v1/packages/show`, `POST /uniget/v1/packages/update-all` y `POST /uniget/v1/packages/update-manager`: necesitan la ventana. Use `POST /uniget/v1/packages/update` para cada paquete en su lugar.

## 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.
