Iniciar sesión

Iniciar sesión

POST /api/v1/ecommerce/login

No pide token: es la ruta que lo entrega.

Cuerpo

Campo	Tipo	Obligatorio	Reglas
username	texto	Sí	El email del cliente. Máximo 200 caracteres
password	texto	Sí	Mínimo 6 caracteres

{ "username": "[email protected]", "password": "clave-del-cliente" }

Si envías la cabecera user-ip-address con el identificador del carrito, ese carrito pasa a la cuenta del cliente. Si no la envías, la sesión se inicia igual. Ver carrito.

Respuesta

{
  "success": true,
  "message": "",
  "data": {
    "user": {
      "id": 12,
      "name": "Ana",
      "last_name": "Pérez",
      "email": "[email protected]",
      "phone": "987654321",
      "api_token": "<token-del-cliente>",
      "has_verified_email": true,
      "avatar": "https://miempresa.ejemplo.com/images/contacto.png",
      "extras": null,
      "country": { "id": "PE", "description": "Perú", "code": "+51" },
      "orders": 0,
      "created_at": "01-02-2025 10:00:00"
    },
    "token": "<token-del-cliente>"
  }
}

• token es el token del cliente. Envíalo en Authorization: Bearer <token> en las rutas que lo piden. Ver autenticación.
• user tiene los mismos campos que el perfil.
• El token no cambia con cada inicio de sesión: se devuelve el mismo hasta que el cliente cierra sesión o cambia su contraseña con el código de recuperación.
• No hace falta tener la cuenta verificada para iniciar sesión.

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

Si algo sale mal

HTTP	code	Cuándo	Qué hacer
422	VALIDATION_ERROR	Falta el email o la contraseña, o el email no es válido	Corrige el campo que indica errors
401	INVALID_CREDENTIALS	Email o contraseña incorrectos, o la cuenta no es de un cliente de la tienda	Pide al cliente que revise sus datos
429	RATE_LIMITED	Demasiados intentos	Espera lo que indica Retry-After