Documentación

La API de partners de BackResto, de principio a fin. Empiece por la guía rápida si ya tiene una clave.

Primeros pasos

Qué es la API de partners y cómo hacer su primera llamada.

Introducción

Qué expone hoy la API de partners de BackResto, qué no expone deliberadamente y quién lo decide.

Obtener una clave

Cómo pedir una clave de la API de partners, qué incluir en la solicitud y qué recibe a cambio.

Guía rápida

De una clave a sus primeros registros y a una fotografía de entrega en cinco minutos, con curl.

Conceptos básicos

Autenticación, errores, paginación y límites de peticiones.

Autenticación

Las claves de partner, los veintiséis scopes, qué significa una concesión y cómo rotar sin interrupciones.

Errores

Un documento de problema legible por máquina para cada fallo, y qué significa cada tipo para su lógica de reintentos.

Paginación

Cómo recorrer cualquier colección con un cursor opaco, y cómo mantener una copia al día.

Límites de peticiones

El presupuesto por clave, la única cabecera que lo describe y cómo no rebasarlo.

Recursos

Los endpoints, campo a campo.

Colecciones y registros

Las veintiséis colecciones de registros, el sobre de snapshot que comparten y cómo recorrer una.

Temperaturas

Temperaturas de frío y de cocción, tomadas por una persona o informadas por un sensor: tres colecciones y qué las distingue.

Etiquetas de trazabilidad

Las etiquetas secundarias que el personal imprime y pega en un recipiente, con el archivo impreso adjunto y un id de grupo por tirada.

Entregas

Los controles de recepción y las fotografías tomadas al recibir: dos colecciones, cada campo y qué significan sobre el terreno.

Limpieza

El plan de limpieza, las tareas realmente hechas y las fotografías que lo demuestran: tres colecciones y qué no prueba un registro ausente.

Freidoras

Las freidoras y sus controles de calidad del aceite: dos colecciones y por qué el valor medido puede faltar mientras que la decisión nunca falta.

Enfriamiento y procesos alimentarios

Enfriamiento, congelación, recalentamiento y transporte: cuatro colecciones que registran una transición de temperatura, y qué aspecto tiene una sin terminar.

Análisis de superficie

Tomas de muestra de superficie: qué se analizó, si pasó y el plan de acción cuando no.

Documentos

El almacén de documentos del propio restaurante (certificados, procedimientos, informes), cada registro un archivo guardado con su propio tipo de medio.

Catálogo

Proveedores, productos y elaboraciones propias: las listas de referencia a las que apunta el resto del registro.

Instalaciones y personas

El local, su personal, sus zonas y sus máquinas: el mapa fijo del que cuelga toda lectura de temperatura.

Agentes y MCP

Conecte BackResto a un cliente de IA mediante MCP.

Servidor MCP

Conecte Claude, Cursor, Codex o cualquier cliente MCP a los registros de cumplimiento de un restaurante con una URL y su clave de API.

Soporte

Versionado, límites de los datos actuales y cómo contactarnos.

Soporte y exhaustividad de los datos

Qué cubren y qué no cubren los datos actuales, cómo se versiona la API y cómo contactar con una persona.