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.

GET /sessions/

Parámetros de Query (opcionais)

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

Respuesta

Status: 200 OK

[
    {
        "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.

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

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

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

Respuesta

Status: 200 OK

{
    "status": "success"
}