Kuenta Docs

Appearance

Cerrar sesión​

POST
/auth/logout

Cierra la sesión del usuario actual, revocando los tokens de acceso y eliminando las cookies de sesión.

Funcionalidades principales:

  • Revocación de tokens: Invalida el refresh token para prevenir reutilización
  • Limpieza de cookies: Elimina cookies de sesión del navegador
  • Auditoría de logout: Registra el evento de cierre de sesión
  • Seguridad completa: Garantiza terminación segura de la sesión

Proceso de logout:

  1. Obtener tokens: Extrae refresh token de la cookie de sesión
  2. Revocar tokens: Invalida el refresh token en el servidor de auth
  3. Limpiar cookies: Elimina todas las cookies de sesión
  4. Confirmar logout: Retorna confirmación de logout exitoso

Seguridad:

  • Invalida inmediatamente todos los tokens asociados
  • Limpia cookies con flags de seguridad apropiados
  • Registra el evento para auditoría
  • Maneja casos donde el token ya está revocado

Casos de uso:

  • Logout manual: Usuario cierra sesión voluntariamente
  • Logout automático: Timeout de sesión o logout forzado
  • Cambio de cuenta: Cerrar sesión para cambiar de usuario
  • Logout de seguridad: Cerrar sesión tras actividad sospechosa

Authorizations​

prod

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
stage

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://stage-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
test

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://test-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
demo

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://demo-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones

Responses​

Logout exitoso. La sesión ha sido cerrada correctamente y todos los tokens han sido revocados.
application/json
JSON
{
"revoked": true,
"status": "string",
"message": "Sesión cerrada exitosamente",
"logged_out_at": "2024-01-15T10:30:00Z"
}

Playground​

Server
Authorization

Samples​

Powered by VitePress OpenAPI