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 único esquema de autenticación y una única 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 a scopes 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, en la siguiente petición, la clave ya está muerta.

Qué hay en los datos

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 carga del 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í, salvo las entregas, que llevan el historial que la aplicación todavía conservaba. No tome un recorrido vacío como prueba de que no ocurrió nada; consulte Soporte.
• Sin escrituras, sin webhooks. Usted hace polling. Si necesita que se los enviemos nosotros, 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.
• Sin inicio de sesión con una cuenta BackResto. La clave de socio sigue siendo la credencial. Los clientes MCP que solo piden una URL, como Claude y ChatGPT, pueden conectarse por OAuth: se abre una página de BackResto donde pegar la clave. Los permisos siguen siendo los de esa clave.

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.