https://api.veriko.mx/v1/users/me Obtener la información completa del usuario actual
Devuelve la información completa del usuario autenticado: perfil + metadatos de API key + suscripción activa + estado de 2FA + permisos del rol + resumen de notificaciones. Un solo roundtrip reemplaza las llamadas múltiples que el dashboard hacía antes a /auth/profile, /billing/subscription y /notifications/unread-count.
curl -X GET 'https://api.veriko.mx/v1/users/me' \
-H 'Authorization: Bearer mxcep_••••'
Ejemplo en Python — próximamente.
Ejemplo en JavaScript — próximamente.
Ejemplo en PHP — próximamente.
| Campo | Tipo | Descripción |
|---|---|---|
id | string (uuid) | Identificador único del usuario (UUID v7). |
email | string (email) | Correo electrónico del usuario, usado para login y notificaciones. |
name | string | Nombre completo del usuario tal como aparece en el panel. |
role | string | Rol del usuario en la organización. Determina los permisos disponibles. |
status | string | Estado de la cuenta. Solo `active` permite operar la API. |
timezone | string | Zona horaria IANA del usuario, usada para formatear timestamps en la UI. |
language | string | Idioma preferido del usuario para UI y notificaciones. |
email_verified_at | string (date-time) anulable | Timestamp ISO 8601 UTC de cuando el usuario verificó su email. `null` si pendiente. |
created_at | string (date-time) | Timestamp ISO 8601 UTC de creación de la cuenta. |
api_key | object anulable | Metadatos de la API key. Nunca devuelve la key completa (usar POST /v1/users/me/api-key/reveal con password para revelar). |
prefix | string | Prefijo de la API key para identificación visual. No incluye la clave completa. |
last_4 | string anulable | Últimos 4 caracteres de la API key para render enmascarado (`veriko_a1b••••••f9c2`). `null` para usuarios pre-v1.49 hasta correr `bin/backfill-api-key-last-4.php`. |
subscription | object anulable | Suscripción activa del usuario. `null` si no hay plan activo. |
plan_slug | string | Identificador del plan contratado (free, pro, enterprise, etc.). |
status | string | Estado actual de la suscripción según el ciclo de billing. |
current_period_end | string (date-time) anulable | Fin del periodo de billing actual (ISO 8601 UTC). |
cancel_at | string (date-time) anulable | Fecha programada de cancelación si el usuario inició cancel-at-period-end. `null` si no hay cancelación pendiente. |
billing_interval | string anulable | Frecuencia de facturación del plan contratado. |
two_factor | object | Estado del segundo factor de autenticación. |
enabled | boolean | `true` si el usuario tiene 2FA activado. |
method | string anulable | Canal de entrega del OTP. `null` si 2FA está deshabilitado. |
last_used_at | string (date-time) anulable | Último uso exitoso del 2FA. Campo futuro, hoy siempre `null`. |
permissions | array | Lista plana de permisos del rol del usuario en formato `resource:action`. |
notifications | object | Resumen de la cola de notificaciones del usuario. |
unread_count | integer | Número de notificaciones sin leer ni archivar. |
push_enabled | boolean | `true` si el usuario tiene al menos una suscripción push activa. |
telegram_linked | boolean | `true` si el usuario tiene un chat de Telegram vinculado. |
_warnings | array | Lista de subsistemas que fallaron al construir este bundle. Solo presente si hubo fallos parciales. Los campos correspondientes a cada subsistema fallido estarán en su valor por defecto (null o vacío). Permite al cliente degradar gracefully en lugar de mostrar pantalla en blanco. |
| Código | Clase | Descripción | Cuerpo |
|---|---|---|---|
| 200 | 2xx | Información completa del usuario autenticado. | Sin cuerpo |
| 401 | 4xx | Se requiere autenticación o las credenciales son inválidas | ErrorResponse |
| Código | Clave | Detalle |
|---|---|---|
| 401 | unauthorized | Invalid or missing authentication credentials. Envelope
|