> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/espanol/api-skyone-autosky/api-aplicaciones.md).

# API Aplicaciones

Llamadas de API para la operación de los objetos Aplicaciones (Aplicaciones Disponibles para los Usuarios).

**Base path:** `/apps/`

Podrá utilizar esta API en situaciones donde el control de aplicaciones disponibles para los usuarios esté fragmentado por cliente. En caso de que utilice controles de aplicaciones a través de permisos dentro de las instancias de template, no será necesario utilizar esta API.

{% hint style="info" %}
**Nota:** Cuando la aplicación se registra, por defecto se registra en el estado de INACTIVA. Utilice la llamada de activación para activar la aplicación después del registro.
{% endhint %}

***

## Listar Aplicaciones

Realiza la consulta de las aplicaciones registradas en la plataforma Autosky y vinculadas a los clientes.

```http
GET /apps/
```

### Parámetros de Query (opcionais)

| Parámetro  | Tipo   | Descripción                  |
| ---------- | ------ | ---------------------------- |
| `cli_uuid` | string | UUID del cliente para filtro |

### Respuesta

**Status:** `200 OK`

```json
[
    {
        "app_uuid": "90476973-4729-4f2b-acee-3621cebd70e8",
        "nome": "Notepad",
        "estado": "INATIVO",
        "endereco_app": "",
        "parametro_app": "",
        "nome_exibicao": ""
    },
    {
        "app_uuid": "84104ec2-6914-4ed7-a359-04ff14316e74",
        "nome": "Calculadora",
        "estado": "ATIVO",
        "endereco_app": "",
        "parametro_app": "",
        "nome_exibicao": ""
    }
]
```

***

## Obtener datos de una aplicación

Obtiene los datos de una aplicación especificada por su UUID. Además de los campos del listado, también incluye el campo `cliente`.

```http
GET /apps/{app_uuid}
```

### Parámetros de Path

| Parámetro  | Obligatorio | Descripción           |
| ---------- | ----------- | --------------------- |
| `app_uuid` | Sí          | UUID de la aplicación |

### Respuesta

**Status:** `200 OK`

```json
{
    "app_uuid": "84104ec2-6914-4ed7-a359-04ff14316e74",
    "nome": "Calculadora",
    "estado": "ATIVO",
    "endereco_app": "",
    "parametro_app": "",
    "cliente": {
        "cli_uuid": "79ea8324-4889-4729-8bf0-bc1c40b38273",
        "nome": "MeuCliente001",
        "grupo_seguranca": "Cliente001",
        "email_admin": "email-adm@dominio.com",
        "has_license_limit": false,
        "license_limit": 0,
        "amb_uuid": "715088c9-9f21-424e-bcd5-5eacc0ce165b"
    },
    "nome_exibicao": ""
}
```

***

## Registrar Aplicación

Realiza el registro de una nueva aplicación en la plataforma.

```http
POST /apps/
```

### Cuerpo de la Solicitud

| Campo           | Tipo   | Obligatorio | Descripción                                                           |
| --------------- | ------ | ----------- | --------------------------------------------------------------------- |
| `nome`          | string | Sí          | Nombre de la aplicación                                               |
| `cli_uuid`      | string | Sí          | UUID del cliente                                                      |
| `estado`        | string | Sí          | Estado de la aplicación: `ATIVO` o `INATIVO`                          |
| `endereco_app`  | string | No          | Dirección de la aplicación (ej: `C:\\Program Files\\MeuDir\\App.exe`) |
| `parametro_app` | string | No          | Parámetro de inicialización de la aplicación                          |

### Ejemplo de Solicitud

```json
{
    "nome": "Teste API",
    "cli_uuid": "54368a47-8040-4cc7-b20b-8b9cc2e86124",
    "estado": "ATIVO"
}
```

### Respuesta

**Status:** `200 OK`

```json
{
    "nome": "teste",
    "estado": "ATIVO",
    "endereco_app": "C:\\\\Program Files\\MeuDir\\App.exe",
    "parametro_app": "CLI:1220",
    "cliente": {
        "cli_uuid": "123-123-123-123",
        "name": "Client name",
        "group_name": "Client group-name",
        "email_admin": "admin@email.com",
        "has_license_limit": false,
        "license_limit": 0,
        "in_maintenance": false,
        "maintenance_msg": ""
    },
    "nome_exibicao": ""
}
```

***

## Editar Aplicación

Realiza la edición de la aplicación en la plataforma

```http
PUT /apps/{app_uuid}
```

### Parámetros de Path

| Parâmetro  | Obligatorio | Descripción       |
| ---------- | ----------- | ----------------- |
| `app_uuid` | Sí          | UUID da aplicação |

### Cuerpo de la Solicitud

| Campo           | Tipo   | Obligatorio | Descripción                                   |
| --------------- | ------ | ----------- | --------------------------------------------- |
| `nome`          | string | Sí          | Nombre de la aplicación                       |
| `cli_uuid`      | string | Sí          | UUID deal cliente                             |
| `estado`        | string | No          | Estado de la aplicación: `ATIVO` ou `INATIVO` |
| `endereco_app`  | string | Sí          | Dirección de la aplicación                    |
| `parametro_app` | string | No          | Parámetro de inicialización                   |

### Ejemplo de Solicitud

```json
{
    "nome": "teste",
    "cli_uuid": "09228c2a-a9a6-4cab-8c57-81620f20bc2f",
    "endereco_app": "C:\\\\Program Files\\MeuDir\\App.exe"
}
```

### Respuesta

**Status:** `200 OK`

Devuelve el objeto completo de la aplicación actualizada con el objeto `cliente`.

***

## Eliminar Aplicación

Realiza a exclusão de uma aplicação na plataforma.

```http
DELETE /apps/{app_uuid}
```

### Parámetros de Path

| Parámetro  | Obligatorio | Descripción           |
| ---------- | ----------- | --------------------- |
| `app_uuid` | Sí          | UUID de la aplicación |

### Respuesta

**Status:** `200 OK`

```json
{
    "status": "success"
}
```


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.skyone.cloud/espanol/api-skyone-autosky/api-aplicaciones.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.