> ## Documentation Index
> Fetch the complete documentation index at: https://reduardo.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Descripción General

> API REST para gestionar productos desde clientes externos como Postman

# API REST de Productos

La API REST permite realizar operaciones CRUD sobre los productos del sistema desde clientes externos como **Postman**, aplicaciones móviles o frontend SPA.

## URL Base

```
http://localhost:8000/api
```

## Autenticación

La API utiliza autenticación basada en **sesiones PHP**. Debes hacer login primero para obtener la cookie `PHPSESSID`.

<Steps>
  <Step title="Hacer login">
    Envía un `POST` a `/api/login` con tus credenciales. La cookie se establece automáticamente.
  </Step>

  <Step title="Usar la API">
    Postman envía la cookie `PHPSESSID` automáticamente en las siguientes peticiones.
  </Step>

  <Step title="Respuesta de error si no autenticado">
    Si no has hecho login, recibirás un HTTP `401` con el mensaje de error.
  </Step>
</Steps>

## Formato de Respuesta

Todas las respuestas son en formato **JSON**.

### Respuesta exitosa

```json theme={null}
{
  "success": true,
  "message": "Operación exitosa",
  "data": { ... }
}
```

### Respuesta de error

```json theme={null}
{
  "error": "Descripción del error"
}
```

## Códigos HTTP Utilizados

| Código | Significado |
| - | - |
| `200` | Operación exitosa |
| `400` | Error de validación (datos incorrectos) |
| `401` | No autorizado (sin sesión) |
| `404` | Producto no encontrado |
| `500` | Error interno del servidor |

## Endpoints Disponibles

| Método | Endpoint | Descripción |
| - | - | - |
| POST | `/api/login` | Iniciar sesión |
| GET | `/api/productos` | Listar todos los productos |
| GET | `/api/productos/{sku}` | Obtener un producto por SKU |
| PUT | `/api/productos/{sku}` | Actualizar producto por SKU |
| DELETE | `/api/productos/{sku}` | Eliminar producto por SKU |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.