Crear cuenta

Crear cuenta

POST /api/v1/ecommerce/register

No pide token: es una de las rutas para conseguirlo.

Cuerpo

Campo	Tipo	Obligatorio	Reglas
name	texto	Sí	Máximo 200 caracteres
last_name	texto	Sí	Máximo 50 caracteres
email	texto	Sí	Email válido, máximo 200 caracteres, no usado por otra cuenta
password	texto	Sí	Mínimo 6 caracteres
country_id	texto	No	Código de un país activo, 2 letras. Sin este campo se usa el país por defecto de la tienda

{ "name": "Ana", "last_name": "Pérez", "email": "[email protected]", "password": "clave-nueva" }

Si envías la cabecera user-ip-address con el identificador del carrito, ese carrito pasa a la cuenta recién creada. Ver carrito.

Respuesta

La cuenta creada, con los mismos campos que el perfil, y el token del cliente ya listo para usar: no hace falta iniciar sesión después de registrarse.

{
  "success": true,
  "message": "Usuario registrado de forma correcta.",
  "data": {
    "id": 12,
    "name": "Ana",
    "last_name": "Pérez",
    "email": "[email protected]",
    "phone": null,
    "api_token": "<token-del-cliente>",
    "has_verified_email": false,
    "avatar": "https://miempresa.ejemplo.com/images/contacto.png",
    "extras": { "lang": "es_ES", "theme": "system", "country_id": "PE" },
    "country": { "id": "PE", "description": "Perú", "code": "+51" },
    "orders": 0,
    "created_at": "28-09-2026 10:00:00"
  }
}

La cuenta se crea sin verificar. Ver verificar la cuenta.

Esta ruta admite 10 peticiones por minuto. Ver límites.

Si algo sale mal

HTTP	code	Cuándo	Qué hacer
422	VALIDATION_ERROR	Falta un campo, no cumple sus reglas, o el email ya lo usa otra cuenta	Corrige el campo que indica errors
429	RATE_LIMITED	Se superó el límite de peticiones	Espera lo que indica Retry-After
500	INTERNAL_ERROR	Fallo del servidor	Reporta la reference

Dos registros con el mismo email al mismo tiempo no crean dos cuentas: el segundo recibe el mismo VALIDATION_ERROR de email en uso, aunque los dos hayan pasado la comprobación inicial.