# Introducción

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

Source: https://developers.backresto.com/es/docs/introduction

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](https://api.backresto.com/openapi.json) 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](https://developers.backresto.com/es/docs/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](https://developers.backresto.com/es/docs/access)
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

| Recurso | Qué es |
| --- | --- |
| [Entregas](https://developers.backresto.com/es/docs/deliveries) | Dos colecciones: un registro por control de recepción (proveedor, veredicto de conformidad, motivos de no conformidad, acciones correctivas, comentario de texto libre, una lectura de temperatura por producto, siempre en Celsius), y las fotos tomadas en la recepción. |
| [Colecciones y registros](https://developers.backresto.com/es/docs/collections) | Veinticuatro tipos de registro más, que comparten un mismo sobre y están documentados por dominio: [temperaturas](https://developers.backresto.com/es/docs/temperatures), [enfriamiento y procesos alimentarios](https://developers.backresto.com/es/docs/food-processes), [limpieza](https://developers.backresto.com/es/docs/cleaning), [freidoras](https://developers.backresto.com/es/docs/fryers), [análisis de superficie](https://developers.backresto.com/es/docs/surface-analyses), [etiquetas de trazabilidad](https://developers.backresto.com/es/docs/traceability-labels), [documentos](https://developers.backresto.com/es/docs/drive-files), [catálogo](https://developers.backresto.com/es/docs/catalogue) y las [instalaciones y las personas](https://developers.backresto.com/es/docs/facilities) que hay detrás. |

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](https://developers.backresto.com/es/docs/support).
- **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](https://developers.backresto.com/es/docs/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

| Entorno | Origen |
| --- | --- |
| Producción | `https://api.backresto.com` |
| Preproducción | `https://api-preprod.backresto.com` |
| Desarrollo | `https://api-dev.backresto.com` |

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](https://developers.backresto.com/es/docs/quickstart).