← Volver al índice de esquemas
UserSession
Una sesión de la cuenta. Nace al entrar, al superar la autenticación de 2 factores (2FA) o al cambiar la contraseña, y de cada una se guarda desde dónde se abrió y hasta cuándo vale.
Propiedades
| Campo | Tipo | Descripción |
|---|---|---|
id* | string (uuid) | Identificador único de la sesión (UUID v7, ordenado por tiempo). Es el valor que consume `DELETE /v1/users/me/sessions/{id}`. |
is_current* | boolean | `true` cuando esta sesión es la que está haciendo la petición. |
ip* | string | null | Dirección IP desde la que se abrió la sesión. `null` cuando no llegó al servidor en ese momento. |
user_agent* | string | null | Cabecera `User-Agent` capturada al abrir la sesión, que es de donde sale el «navegador · sistema» que muestra la interfaz. `null` cuando el cliente no la envió. |
created_at* | string (date-time) | Fecha y hora en que se abrió la sesión, en ISO 8601 UTC. Coincide con el inicio de sesión, la 2FA o el cambio de contraseña que la creó. |
last_used_at* | string (date-time) | Fecha y hora de la última petición autenticada que usó esta sesión, en ISO 8601 UTC. Se actualiza en cada petición y es lo que ordena la lista. |
expires_at* | string (date-time) | Fecha y hora en que la sesión caduca sola, en ISO 8601 UTC. Son 4 horas desde que se abrió, o 24 cuando al entrar se pidió recordar el dispositivo. Pasado ese instante la sesión se rechaza con `session_expired`. |
Usado en operaciones
GET /v1/users/me/sessions