Appearance
Obtener token de acceso OAuth2
POST
/oauth/token
Implementación del Token Endpoint según RFC 6749 §3.2.
Este endpoint soporta múltiples grant types OAuth 2.0:
- Client Credentials Grant (RFC 6749 §4.4): Autenticación aplicación-a-aplicación
- Resource Owner Password Credentials Grant (RFC 6749 §4.3): Autenticación con credenciales de usuario
- Refresh Token Grant (RFC 6749 §6): Renovación de tokens de acceso
- MFA TOTP Grant (Extensión Kuenta): Autenticación multi-factor con TOTP
El token obtenido puede ser utilizado como Bearer token para autenticar llamadas subsecuentes a la API.
Request Body
application/x-www-form-urlencoded
grant_type
string
Grant type según RFC 6749:
- client_credentials: Client Credentials Grant (§4.4) - Para autenticación de aplicaciones
- password: Resource Owner Password Credentials Grant (§4.3) - Para autenticación con credenciales de usuario
- refresh_token: Refresh Token Grant (§6) - Para renovar tokens de acceso
- mfa_totp: Multi-Factor Authentication TOTP (Extensión Kuenta) - Para completar autenticación MFA
Valid values
client_credentialspasswordrefresh_tokenmfa_totpclient_id
string
Required
ID del cliente OAuth2
client_secret
string
Required
Secret del cliente OAuth2
Format
passwordscope
string
Alcance solicitado para el token (opcional).
Valores disponibles: "*", "users:read", "users:write", "clients:read", "clients:write", etc.
username
string
Nombre de usuario (teléfono).
Requerido para: password grant
password
string
Contraseña del usuario.
Requerido para: password grant
Format
passwordrefresh_token
string
Token de renovación válido.
Requerido para: refresh_token grant
mfa_token
string
Token MFA obtenido del flujo de autenticación multi-factor.
Requerido para: mfa_totp grant
totp
string
Código TOTP de 6 dígitos generado por la aplicación de autenticación.
Requerido para: mfa_totp grant
Responses
Token de acceso generado exitosamenteSchema client_credentials password_grant JSON JSON
application/json
{
"access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
"token_type": "Bearer",
"expires_in": 3600,
"scope": "users:read clients:write"
}