Cambios de la API
La v1 solo crece: agregamos campos, endpoints y eventos, nunca quitamos ni cambiamos el significado de lo que ya existe. Un cambio incompatible sería una v2 con su propia URL.
· v1
Lanzamiento de la API v1, webhooks y exportación completa
- Llaves por sucursal o por organización con alcances, vencimiento opcional y revocación al instante; llaves de prueba (kmd_test_) sobre un restaurante de prueba sembrado para tu organización.
- Lectura de restaurantes, categorías, productos (variantes, modificadores, precios por sucursal e IVA), órdenes, turnos y cortes del día, clientes, reservas, pedidos en línea, insumos, movimientos de inventario, gastos, empleados y jornadas.
- Escritura: productos y precios (con la herencia del menú maestro), agotar y reactivar, pedidos por el mismo camino que la tienda en línea, reservas (crear, modificar, cancelar), entradas de inventario y alta de clientes. Toda escritura operativa es un evento, como en el POS.
- Paginación por cursor, updated_since para sincronizar, montos en texto decimal y en centavos, instantes ISO con zona, errores con código estable en español e inglés, Idempotency-Key obligatoria en escrituras y cuota por minuto con cabeceras X-RateLimit-*.
- Webhooks firmados (HMAC-SHA256 con timestamp) con reintentos durante 24 h, desactivación automática con aviso al dueño, bitácora, reenvío y entrega de prueba.
- OpenAPI 3.1 generado del código en /api/v1/openapi.json.
- Exportación completa de los datos del restaurante u organización en ZIP (núcleo gratis) desde Configuración → Tus datos.