API Catalogo para un Ecommerce

Requisitos

- Php 8
- MariaDB 10
- Laravel 10
- Nodejs 20

Instalación

Clonamos el repositorio

git clone https://github.com/ccjuantrujillo/api-catalogo.git

Instalamos las dependencias de PHP

composer install

Instalamos dependencias NPM

npm ci

Construimos el assets

npm run dev

Instalamos el archivo de configuracion y configuramos la base de datos

cp .env.example .env

Generamos una llave para la aplicacion

php artisan key:generate

Ejecutamos las migraciones

php artisan migrate

Ejecutamos los seeders

php artisan db:seed

Ejecutamos el servidor

php artisan serve

Rutas de la API

Autenticación (Usuarios y Administradores)

Método	Endpoint	Descripción
POST	/api/register	Registro de un nuevo usuario
POST	/api/login	Inicio de sesión de un usuario
POST	/api/logout	Cierre de sesión (requiere token de auth)
GET	/api/profile	Obtener perfil del usuario autenticado

Productos (Acceso Público)

Método	Endpoint	Descripción
GET	/api/productos	Listar todos los productos
GET	/api/productos/{id}	Ver detalles de un producto específico
GET	/api/categorias	Listar todas las categorías
GET	/api/categorias/{id}/productos	Listar productos por categoría

Carrito de Compras (Requiere Autenticación)

Método	Endpoint	Descripción
GET	/api/carrito	Ver contenido del carrito de compras
POST	/api/carrito/agregar	Agregar un producto al carrito
PUT	/api/carrito/actualizar	Actualizar la cantidad de un producto en el carrito
DELETE	/api/carrito/eliminar	Eliminar un producto del carrito
DELETE	/api/carrito/vaciar	Vaciar todo el contenido del carrito

Pedidos (Requiere Autenticación)

Método	Endpoint	Descripción
POST	/api/pedidos	Crear un nuevo pedido (proceso de checkout)
GET	/api/pedidos	Listar todos los pedidos del usuario autenticado
GET	/api/pedidos/{id}	Ver detalles de un pedido específico del usuario

Panel Administrativo (Solo Administradores)

Gestión de Productos

Método	Endpoint	Descripción
GET	/api/admin/products	Listar todos los productos
POST	/api/admin/products	Crear un nuevo producto
PUT	/api/admin/products/{id}	Actualizar un producto existente
DELETE	/api/admin/products/{id}	Eliminar un producto

Gestión de Categorías

Método	Endpoint	Descripción
GET	/api/admin/categories	Listar todas las categorías
POST	/api/admin/categories	Crear una nueva categoría
PUT	/api/admin/categories/{id}	Actualizar una categoría existente
DELETE	/api/admin/categories/{id}	Eliminar una categoría

Gestión de Pedidos

Método	Endpoint	Descripción
GET	/api/admin/orders	Ver todos los pedidos
GET	/api/admin/orders/{id}	Ver detalles de un pedido específico
PUT	/api/admin/orders/{id}/estado	Cambiar el estado de un pedido

---

Autenticación

Para las rutas que requieren autenticación, se debe incluir un token JWT en el encabezado Authorization con el prefijo Bearer.

Ejemplo: Authorization: Bearer YOUR_JWT_TOKEN { "email": "mpalacios@gmail.com", "password": "mpalacios" }