Introducción

BackResto es la aplicación de cumplimiento APPCC que los equipos de restauración rellenan durante el servicio: controles de recepción, temperaturas de cocción y enfriamiento, planes de limpieza, etiquetas. La API de partners entrega ese registro al software que sus clientes ya utilizan: un ERP, un portal de proveedores, un cuadro de mando de calidad, un asistente de IA.

Es una API HTTP de solo lectura con un esquema de autenticación y una forma de error, descrita de principio a fin por un documento OpenAPI que puede cargar directamente en un generador de clientes o en la definición de una herramienta para un LLM. Los mismos datos están disponibles por MCP en https://api.backresto.com/mcp, con la misma clave y los mismos permisos, si lo que quiere es hacer preguntas en lugar de escribir un cliente.

El restaurante decide lo que usted ve

Esta es la parte que conviene leer dos veces, porque es distinta de la mayoría de las API con las que va a integrarse.

No hay registro de alta. Las claves se emiten a mano, acotadas a restaurantes concretos y permisos concretos, y solo una vez que los restaurantes en cuestión lo han aceptado. Pida una por correo electrónico —Obtener una clave es la lista de comprobación— y llega al contacto técnico que indique.

La consecuencia es tajante: una clave alcanza los restaurantes que se le concedieron y nada más. restaurant-3 no aparece porque restaurant-1 y restaurant-2 estén en la misma clave, y ninguna petición que usted pueda hacer amplía eso. Añadir un local es otra conversación, con las personas de quienes son los datos.

La ventaja de un pequeño paso manual es que la revocación es igual de directa: un correo electrónico y la clave está muerta en la siguiente petición.

Qué hay en los datos

Las entregas son un recurso diseñado; las colecciones le entregan el registro tal como lo guarda la aplicación, en un único sobre genérico. Lo segundo es la vía por la que un módulo llega a esta API la semana en que sale, y no el trimestre siguiente.

Todo ello es de solo lectura. Nada de lo que pueda llamar una clave de partner escribe en los registros de un restaurante: la aplicación es donde se crean los datos de cumplimiento, por la persona que responde de ellos.

Qué no está aquí todavía

Ser explícitos sobre los límites le ahorra una tarde:

• Sin relleno histórico. Los registros de un restaurante se hacen visibles para esta API desde el momento en que se activa la captura para ese restaurante. Lo anterior está en la aplicación, no aquí. No tome un rango vacío como prueba de que no ocurrió nada; consulte Soporte.
• Sin escrituras, sin webhooks. Usted consulta. Si necesita que se los enviemos, díganoslo; es una cuestión de demanda, no de principios.
• Sin cursor incremental en las colecciones. Actualizar una colección significa volver a recorrerla y conciliar por id. Las entregas, que son inmutables, toman en su lugar un rango de tiempo.
• Sin inicio de sesión OAuth. Todos los clientes se autentican con una clave, también por MCP. Las herramientas que exigen una página de inicio de sesión todavía no pueden conectarse.

URL base

Una clave se aprovisiona en un entorno y no significa nada en los demás: las claves, las concesiones y los datos son por entorno. Todo lo que sigue usa el origen de producción.

¿Listo? Haga su primera llamada.