Conectar tu propio sistema o web con la API de Delimenu
Crea una clave de API para gestionar tu menú desde tu software, o muestra tu carta en una web hecha a tu medida.
Además del panel y de los agentes de IA, Delimenu tiene una API para quien programa: sirve para gestionar tu menú desde tu propio sistema (una caja, un inventario, un script) y para mostrar tu carta en una web o app que hagas tú, con tu diseño.
Este artículo explica cómo obtener acceso. La documentación técnica completa, con todos los endpoints y ejemplos, está en delimenu.co/developers.
Importante: todo lo que hagas por la API cambia tu menú de verdad, igual que si lo hicieras desde el panel. No hay borrador ni botón de publicar.
Dos formas de usarla
Mostrar tu menú en tu propia web. La carta pública de cualquier restaurante se puede leer sin clave: la misma información que ve un comensal en delimenu.co/tu-identificador, en formato JSON, lista para pintarla como quieras. Tú sigues cargando y editando el menú en Delimenu; tu web solo lo muestra.
Gestionar el menú desde tu sistema. Con una clave de API puedes crear, editar y borrar categorías y productos, cambiar precios y disponibilidad, subir fotos, y editar los datos del restaurante. Es lo mismo que puede hacer un agente de IA, pero desde tu programa.
Crear una clave de API
- Abre tu restaurante y ve a "Configuración".
- Busca la tarjeta "API para desarrolladores" y pulsa "Crear clave".
- Ponle un nombre que te ayude a reconocerla (por ejemplo, "sistema de caja") y elige sus permisos: ver el menú, o ver y editar.
- Copia la clave cuando aparezca. Solo se muestra esa vez: si la pierdes, revócala y crea otra.
La clave es de tu cuenta, no de un restaurante: sirve para todos los restaurantes que tengas. Puedes tener hasta 10 claves activas por cuenta. La URL base de la API es https://delimenu.co/api/v1.
Revocar una clave
- Ve a "Configuración" › "API para desarrolladores".
- En "Claves activas", pulsa "Revocar" junto a la clave.
Desde ese momento deja de funcionar, en la siguiente petición. Revoca cualquier clave que se haya compartido por error o que ya no uses.
Recibir avisos cuando cambia el menú (webhooks)
Si tu sistema necesita enterarse de los cambios —por ejemplo, para mantener tu caja o tu tienda en línea al día—, no hace falta que consulte la API cada rato: registra un webhook y Delimenu le avisará a tu sistema cada vez que se cree, edite o borre un producto o una categoría, o cambien los datos del restaurante.
- Abre tu restaurante y ve a "Configuración".
- Busca la tarjeta "Webhooks" y pulsa "Crear webhook".
- Escribe la URL de tu sistema (tiene que empezar por
https://) y elige los eventos que quieres recibir. - Copia el secreto cuando aparezca. Solo se muestra esa vez: con él tu sistema comprueba que cada aviso viene de verdad de Delimenu. Si lo pierdes, pulsa "Nuevo secreto".
- Pulsa "Enviar prueba" para comprobar que tu sistema recibe los avisos.
Los webhooks son de cada restaurante, no de la cuenta: puedes tener hasta 5 por restaurante. Si tu sistema no responde, lo reintentamos hasta 8 veces durante cerca de un día. Si fallan 20 avisos seguidos, el webhook se desactiva solo; revisa tu sistema y pulsa "Activar". En "Historial" ves los últimos envíos y cómo respondió tu sistema.
Preguntas frecuentes
¿Necesito un plan activo? Para gestionar un restaurante por la API, sí: solo funciona con suscripción o prueba gratuita activa, igual que el panel. Para mostrar la carta en tu web, el restaurante también tiene que tener plan activo; si no lo tiene, la API responde que el menú no está disponible, igual que la página pública.
¿Puedo dar la clave a mi desarrollador? Sí, es para eso. Crea una clave solo para esa persona o sistema, con los permisos justos, y revócala cuando termine el trabajo. Nunca compartas una clave con permiso de edición si solo necesitan leer el menú.
¿La clave da acceso a mi facturación o a mi cuenta? No. Solo puede ver y editar los menús. No puede gestionar la suscripción, eliminar el restaurante ni entrar al panel.
¿En qué formato van los precios?
Igual que en el menú: 12500 son $ 12.500 pesos, 5.99 son US$ 5,99. Nunca en centavos.
¿Los cambios se ven al momento? Sí. Tanto en el menú público como en la lectura por la API, en segundos.