Gestión de Contraseñas

Gestión de Contraseñas

Endpoints para la gestión y recuperación de contraseñas de usuarios.

POST /api/v1/password/restore

Establece una nueva contraseña para el usuario.

Headers requeridos

Content-Type: application/json
Accept: application/json

Parámetros del cuerpo

Parámetro	Tipo	Requerido	Descripción
token	string	Sí	Token de recuperación de contraseña
password	string	Sí	Nueva contraseña
password_confirmation	string	Sí	Confirmación de la nueva contraseña

Ejemplo de solicitud

{
    "token": "abc123def456",
    "password": "nuevaContraseña123",
    "password_confirmation": "nuevaContraseña123"
}

Respuestas

200 OK

{
    "message": "Contraseña actualizada exitosamente",
    "status": "OK"
}

422 Unprocessable Content

{
    "message": "Los datos proporcionados no son válidos",
    "errors": {
        "password": [
            "La contraseña debe tener al menos 8 caracteres"
        ],
        "password_confirmation": [
            "La confirmación de contraseña no coincide"
        ]
    }
}

404 Not Found

{
    "message": "Token de recuperación inválido o expirado",
    "status": "ERROR"
}

PUT /api/v1/users/change-my-password

Cambia la contraseña del usuario autenticado.

Headers requeridos

Content-Type: application/json
Accept: application/json
Authorization: Bearer {token}

Parámetros del cuerpo

Parámetro	Tipo	Requerido	Descripción
current_password	string	Sí	Contraseña actual
password	string	Sí	Nueva contraseña
password_confirmation	string	Sí	Confirmación de la nueva contraseña

Ejemplo de solicitud

{
    "current_password": "contraseñaActual123",
    "password": "nuevaContraseña456",
    "password_confirmation": "nuevaContraseña456"
}

Respuestas

200 OK

{
    "message": "Contraseña actualizada exitosamente",
    "status": "OK"
}

422 Unprocessable Content

Contraseña actual incorrecta:

{
    "message": "Los datos proporcionados no son válidos",
    "errors": {
        "current_password": [
            "La contraseña actual es incorrecta"
        ]
    }
}

Validación de nueva contraseña:

{
    "message": "Los datos proporcionados no son válidos",
    "errors": {
        "password": [
            "La contraseña debe tener al menos 8 caracteres"
        ],
        "password_confirmation": [
            "La confirmación de contraseña no coincide"
        ]
    }
}

401 Unauthorized

{
    "message": "Token inválido o expirado",
    "status": "ERROR"
}