Register User

Create a new user account in the system

POST /api/auth/register

Register User

cURL

curl --request POST \
  --url https://api.example.com/api/auth/register

200

{
  "success": true,
  "message": "<string>",
  "data": {
    "user": {
      "user_id": 123,
      "name": "<string>",
      "email": "<string>",
      "role_id": 123,
      "status": "<string>",
      "registration_date": "<string>"
    },
    "token": "<string>"
  }
}

Description

Creates a new user account in the system. The user is created with the “user” role (role_id: 2) by default. The password must meet security requirements (minimum 8 characters, uppercase, lowercase, number, and special character).

Authentication

This endpoint is public and does not require authentication.

Rate Limiting

• Limit: 50 requests per 15 minutes per IP address
• Error Message: “Demasiadas peticiones desde esta IP, por favor intente más tarde.”

Request Body

name · string · required

Full name of the user

email · string · required

User’s email address (must be valid format)

password · string · required

User’s password (minimum 8 characters, must include uppercase, lowercase, number, and special character)

Response

success · boolean

Indicates if the request was successful

message · string

Human-readable response message

data · object

Response data containing user information and authentication token

Show data properties

user · object

User information

Show user properties

user_id · integer

Unique user identifier

name · string

User’s full name

email · string

User’s email address

role_id · integer

Role identifier (2 for regular user)

status · string

User status (always “active” for new users)

registration_date · string

ISO 8601 timestamp of registration

token · string

JWT authentication token to use for protected endpoints

Example Request

cURL

curl -X POST https://api.maqagr.com/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Juan Pérez",
    "email": "[e-mail]",
    "password": "MiPassword123!"
  }'

JavaScript

const response = await fetch('https://api.maqagr.com/api/auth/register', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Juan Pérez',
    email: '[e-mail]',
    password: 'MiPassword123!'
  })
});

const data = await response.json();

Python

import requests

response = requests.post(
    'https://api.maqagr.com/api/auth/register',
    json={
        'name': 'Juan Pérez',
        'email': '[e-mail]',
        'password': 'MiPassword123!'
    }
)

data = response.json()

Success Response (201)

{
  "success": true,
  "message": "Usuario registrado exitosamente",
  "data": {
    "user": {
      "user_id": 1,
      "name": "Juan Pérez",
      "email": "[e-mail]",
      "role_id": 2,
      "status": "active",
      "registration_date": "2026-02-13T10:00:00.000Z"
    },
    "token": "eyJhbGciOiJIUzI1NiIs..."
  }
}

Error Responses

400 - Missing Required Fields

{
  "success": false,
  "message": "Datos de entrada incompletos",
  "errors": [
    "Nombre es requerido",
    "Email es requerido"
  ]
}

400 - Invalid Email Format

{
  "success": false,
  "message": "Formato de email inválido"
}

400 - Weak Password

{
  "success": false,
  "message": "Contraseña no cumple requisitos",
  "errors": [
    "Debe tener al menos 8 caracteres",
    "Debe incluir una mayúscula"
  ]
}

409 - Email Already Registered

{
  "success": false,
  "message": "El email ya está registrado"
}

500 - Internal Server Error

{
  "success": false,
  "message": "Error interno del servidor"
}