# MAURICIO POS & Foodtech API

> Mauricio es la plataforma tecnológica integral para restaurantes en México, proporcionando APIs RESTful para reservaciones públicas, catálogo POS de productos, menús digitales, sincronización Foodtech y hardware de impresión Edge.

## Guías e Integración Rápida
- [OpenAPI 3.0 Specification](https://mau.rest/api/v1/openapi.json): Especificación machine-readable completa en formato JSON.
- [API Reference (Scalar UI)](https://mau.rest/developers/api-reference): Consola interactiva para probar endpoints en tiempo real.
- [Guía de Autenticación & Errores](https://mau.rest/developers/docs): Las peticiones protegidas requieren la cabecera `X-API-Key`.
- [Documentación Completa (llms-full.txt)](https://mau.rest/llms-full.txt): Versión exhaustiva concatenada de toda la API en texto plano.

## Módulos de la API

### 1. Public Booking API
- [POST /api/v1/public/booking/available-slots](https://mau.rest/developers/api-reference): Consulta de disponibilidad de mesas por fecha y número de personas.
- [POST /api/v1/public/booking/create](https://mau.rest/developers/api-reference): Registro y confirmación directa de reservación.
- [GET /api/v1/public/booking/restaurant-info](https://mau.rest/developers/api-reference): Datos públicos y políticas de la sucursal.

### 2. POS & Catalog API
- [GET /api/v1/pos/menus](https://mau.rest/developers/api-reference): Catálogo de menús digitales y categorías.
- [GET /api/v1/pos/products](https://mau.rest/developers/api-reference): Productos, precios, modificadores y estado de stock.
- [GET /api/v1/pos/reservations](https://mau.rest/developers/api-reference): Reservaciones vinculadas al punto de venta.
- [GET /api/v1/pos/schedules](https://mau.rest/developers/api-reference): Horarios operativos y turnos.
- [GET /api/v1/pos/stations](https://mau.rest/developers/api-reference): Estaciones de comanda (Cocina, Barra).

### 3. Foodtech Integrations API
- [GET /api/v1/foodtech/menus](https://mau.rest/developers/api-reference): Carta formateada para agregadores (Rappi / UberEats).
- [GET /api/v1/foodtech/photos](https://mau.rest/developers/api-reference): Galería de imágenes y assets visuales.

### 4. Hardware Print Bridge API (Edge)
- [POST /api/print-bridge/v1/register](https://mau.rest/developers/api-reference): Enrolamiento y re-autenticación de agente Raspberry Pi.
- [POST /api/print-bridge/v1/heartbeat](https://mau.rest/developers/api-reference): Telemetría y estado de impresoras térmicas.
- [POST /api/print-bridge/v1/jobs/claim](https://mau.rest/developers/api-reference): Sondeo de comandas locales ESC/POS.

## Ejemplo de Código (Python Client)
```python
import requests

def get_available_slots(restaurant_slug, date, party_size):
    url = "https://mau.rest/api/v1/public/booking/available-slots"
    payload = {
        "restaurant_slug": restaurant_slug,
        "date": date,
        "party_size": party_size
    }
    response = requests.post(url, json=payload)
    return response.json()
```