Base URL: http://localhost:3001/api/v1
All successful responses follow the envelope:
{ "success": true, "message": "...", "data": { ... } }
{ "success": false, "message": "...", "errors": [...] }
POST /register
Create a new user account. No token is issued on registration.
No authentication required.
Email address. Must be unique.
Plain-text password. Hashed before storage.
curl -X POST http://localhost:3001/api/v1/register \
-H "Content-Type: application/json" \
-d '{
"nombre": "Ada Lovelace",
"email": "[email protected]",
"password": "Secure123"
}'
201 Created
{
"success": true,
"message": "User registered successfully.",
"data": {
"id_usuario": 42,
"nombre": "Ada Lovelace",
"email": "[email protected]",
"rol": 1
}
}
POST /login
Authenticate with email and password. Returns a JWT access token.
No authentication required.
Registered email address.
curl -X POST http://localhost:3001/api/v1/login \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"password": "Secure123"
}'
200 OK
{
"success": true,
"message": "Login successful.",
"data": {
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"usuario": {
"id_usuario": 42,
"nombre": "Ada Lovelace",
"email": "[email protected]",
"rol": 1
}
}
}
accessToken as a Bearer token in the Authorization header for all authenticated endpoints:
Authorization: Bearer <accessToken>