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, pagos, cierres y catálogo. Es la que necesitas si integras food cost. Desplegada y respondiendo. 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: usa la v2, que ya está desplegada y respondiendo. Empieza por api.sandbox.digibite.app con una clave dgb_test_…; una clave de pruebas no abre producción, ni al revés.

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.