Digibite

API para integradores

Acceso de lectura a los locales, cartas y ventas de tu organización, para conectar Digibite con tu ERP, tu back-office o tu sistema de gestión.

Referencia de la API v2 → Ventas, jornadas y catálogo. Es la que necesitas si integras food cost. Vista previa del contrato: todavía no responde. Contrato v2 en crudo → OpenAPI 3.1, para generar clientes o cargarlo en Postman. Referencia de la v1 → Congelada. Locales, cartas y contacto. Contrato v1 en crudo → El OpenAPI de la versión congelada.

Entornos

Entorno URL base Datos
Producción https://api-digibite.web.app Locales reales en explotación.
Pruebas https://ptw-api.web.app Datos de desarrollo. Integra aquí primero.

Las credenciales no son intercambiables entre entornos. Una clave de pruebas no vale en producción ni al revés. Si recibes 401 justo después de cambiar de URL, es esto.

Autenticación

Cabecera x-api-key en todas las peticiones. Tu credencial queda acotada a una organización: solo verás sus locales y sus datos. 

curl https://api-digibite.web.app/restaurants/list \
  -H "x-api-key: TU_CLAVE"

Es una API de servidor a servidor. No pongas la clave en un frontend: ahí es pública por definición. Por eso no hay CORS habilitado.

Límites de uso

120 peticiones por minuto y por IP. Cada respuesta trae RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset; al superarlo recibes 429 con Retry-After en segundos.

Versiones

La v1 está congelada y marcada como obsoleta: sus respuestas llevan Deprecation: true. Está en preparación una v2 con ventas, catálogo completo por modo de venta y sincronización incremental para integradores que consultan periódicamente.

Si vas a integrar ventas —consumo teórico, escandallos, food cost— la v1 no es lo que necesitas: la referencia de la v2 ya está publicada y puedes empezar a construir contra ella. Los endpoints todavía no responden; te avisamos con la fecha y con tus credenciales de pruebas.

Cómo empezar

Las credenciales se emiten a petición. Escribe a integrations@digibite.app indicando la organización con la que vas a integrar y qué datos necesitas leer, y te damos una clave de pruebas.