Autenticación
Iniciar sesión
POST /v1/login
Este endpoint permite a los usuarios obtener un token de autenticación para usar en requests subsiguientes.
Antes de ejecutar cualquier acción es necesario autenticarse utilizando el access_token que se obtiene del request de Login. Este debe ser enviado como header en los request subsiguientes.
Authorization: Bearer {access_token} | Parámetros | Descripción |
|---|---|
| user |
|
| password |
|
user_type
|
|
En el primer intento de inicio de sesión de un usuario creado o un usuario al que se le restauró la contraseña, el response indicará que es necesario hacer un cambio de contraseña. Para cumplir con este requisito, se debe enviar una solicitud de Cambio de contraseña.
Los intentos fallidos se cuentan por user. Al superar el límite (por defecto 10 intentos en 60 segundos) la respuesta es 429. En un 400, el mensaje describe el motivo del error.
curl --request POST \
--url https://api.menta.global/api/v1/login \
--header 'Content-Type: application/json' \
--data '{
"user": "string",
"password": "string"
}' {
"token": {
"access_token": "example access_token",
"id_token": "example id_token",
"expires_in": 86400,
"token_type": "Bearer",
"refresh_token": "example refresh token",
"refresh_expires_in": 86400
}
}refresh_token y refresh_expires_in son opcionales.