> 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-sesiones.md).

# API Sesiones

Llamadas de API para la operación de sesiones de Usuarios.

```
Base path: /sessions/
```

Esta API puede ser utilizada para el control de sesiones de usuarios. Podrá listar las sesiones activas, desconectar usuarios y/o enviar mensajes que se presentarán a los usuarios.

***

## Listar Sesiones

Realiza la consulta de las sesiones que están activas en la plataforma Autosky.

```http
GET /sessions/
```

### Parámetros de Query (opcionais)

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

### Respuesta

**Status:** `200 OK`

```json
[
    {
        "ssid": "9cfb4863",
        "client": {},
        "user": {},
        "instance": {},
        "creation_date": "2017-10-02T18:35:14.470434Z",
        "termination_date": null,
        "termination_reason": "",
        "status": "ativa",
        "my_ip": "99.99.99.99"
    }
]
```

### Campos del Objeto Sesión

| Campo                | Tipo        | Descripción                                    |
| -------------------- | ----------- | ---------------------------------------------- |
| `ssid`               | string      | Identificador único de la sesión               |
| `client`             | object      | Datos del cliente asociado                     |
| `user`               | object      | Datos del usuario asociado                     |
| `instance`           | object      | Datos de la instancia                          |
| `creation_date`      | string      | Fecha/hora de creación de la sesión (ISO 8601) |
| `termination_date`   | string/null | Fecha/hora de finalización de la sesión        |
| `termination_reason` | string      | Motivo de la finalización                      |
| `status`             | string      | Estado de la sesión (ej: activa)               |
| `my_ip`              | string      | IP del usuario                                 |

***

## Obtener datos de una sesión

Obtiene los datos de una sesión especificada por su identificador.

```http
GET /sessions/{ssid}
```

### Parámetros de Path

| Parámetro | Obligatorio | Descripción           |
| --------- | ----------- | --------------------- |
| `ssid`    | Sí          | ID único de la sesión |

### Respuesta

**Status:** `200 OK`

Devuelve el objeto de la sesión con la misma estructura del listado.

***

## Remover Sesión

Procedimiento de eliminación/desconexión de un usuario.

Cuando se utiliza, envía un mensaje de desconexión al usuario con un temporizador de apagado. En caso de que el usuario no cierre la sesión espontáneamente, la sesión se finaliza dentro del temporizador definido (en minutos).

```http
DELETE /sessions/{ssid}
```

### Parámetros de Path

| Parámetro | Obligatorio | Descripción           |
| --------- | ----------- | --------------------- |
| `ssid`    | Sí          | ID único de la sesión |

### Cuerpo de la Solicitud

| Campo     | Tipo   | Obligatorio | Descripción                                         |
| --------- | ------ | ----------- | --------------------------------------------------- |
| `time`    | number | Sí          | Tiempo en minutos para la finalización de la sesión |
| `message` | string | No          | Mensaje de advertencia de desconexión               |

### Ejemplo de Solicitud

```json
{
    "time": 10,
    "message": "Mantenimiento preventivo en 10 minutos"
}
```

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