API Pública

Endpoints REST autenticados con API Key para conectar Zapier, n8n, scripts o tu propio POS.

Autenticación

Generá una API Key desde Configuración → API Keys (sólo admin). El token empieza con sk_live_ y se muestra una única vez. Enviálo en el header Authorization:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx

Scopes disponibles

pedidos:read — leer pedidos
pedidos:write — crear/actualizar pedidos (próximamente)
inventario:read — leer inventario (próximamente)
clientes:read — leer clientes (próximamente)
dinero:read — leer movimientos (próximamente)

GET /api/public/v1/pedidos

Últimos pedidos (máx 200). Requiere scope pedidos:read.

curl "/api/public/v1/pedidos?limit=50" \
  -H "Authorization: Bearer sk_live_..."

Respuesta:

{
  "data": [
    {
      "id": "uuid",
      "numero": 123,
      "estado": "pendiente",
      "canal": "web",
      "total": 12500,
      "cliente_nombre": "Juan",
      "created_at": "2026-07-07T12:00:00Z"
    }
  ]
}

Límites

100 requests por minuto por API key.
Respuestas: 401 token inválido, 403 scope faltante, 429 límite excedido.
Todo uso queda registrado en el log de actividad.