Saltar al contenido principal

Registro de Usuario (v1 - Legacy)

Este flujo no se usa actualmente como flujo principal, pero se mantiene disponible por compatibilidad.

Estado del endpoint

Legacy (v1): documentación del comportamiento actual de POST /auth/register. No es el flujo recomendado para nuevas integraciones.

Modo A: Iniciar Registro (sin token)​

POST/auth/register

Inicia el registro con un email. Retorna un token de sesión de registro.

📋 Parámetros

emailstringrequerido

Email del nuevo usuario

📤 Respuesta

{
"code": 1010,
"message": "Verification code sent successfully",
"data": {
  "token": "session-token"
}
}

Respuestas​

Inicio Exitoso

Código 1010 - Sesión de registro iniciada.

{
  "code": 1010,
  "message": "Verification code sent successfully",
  "data": { "token": "session-token" }
}

Datos Faltantes o Email Inválido

Código 4006 - Falta email o el formato es inválido.

{
  "code": 4006,
  "message": "Missing required data",
  "data": null
}

HTTP: 400 Bad Request

Email Ya Registrado

Código 4002 - El email ya está registrado.

{
  "code": 4002,
  "message": "The email is already registered",
  "data": null
}

HTTP: 409 Conflict

Modo B: Completar Registro (con token)​

POST/auth/register?token={token}

Completa el registro creando el usuario con contraseña. Requiere token válido y verificado.

📋 Parámetros

tokenstringrequerido

Token de sesión de registro (query param)

passwordstringrequerido

Contraseña del usuario

📤 Respuesta

{
"code": 1000,
"message": "Registration completed successfully",
"data": null
}

Requisito previo

Para completar el registro con token, el backend requiere que el token esté previamente verificado por el flujo de verificación de email correspondiente. (La verificación se documenta en su endpoint específico.)

Respuestas​

Registro Completado

Código 1000 - Usuario creado correctamente.

{
  "code": 1000,
  "message": "Registration completed successfully",
  "data": null
}

Token de Registro Inválido

Código 4015 - Token inválido o no encontrado.

{
  "code": 4015,
  "message": "Invalid or expired token",
  "data": null
}

HTTP: 400 Bad Request

Token No Verificado

Código 4005 - El token no está verificado (no se permite completar registro).

{
  "code": 4005,
  "message": "Invalid verification code",
  "data": null
}

HTTP: 403 Forbidden

Datos Faltantes

Código 4006 - Falta password.

{
  "code": 4006,
  "message": "Missing required data",
  "data": null
}

HTTP: 400 Bad Request

Contraseña Inválida

Código 4008 - La contraseña no cumple los requisitos.

{
  "code": 4008,
  "message": "The provided password does not meet the required criteria",
  "data": null
}

HTTP: 400 Bad Request

Error del Servidor

Código 5001 - Error interno al crear usuario.

{
  "code": 5001,
  "message": "Failed to save user to the database",
  "data": null
}

HTTP: 500 Internal Server Error

Notas​

Auto-autorización de dispositivo

Al completar el registro, el backend puede auto-autorizar el dispositivo actual (IP/User-Agent) creando una sesión confiable.

Enlaces Relacionados​