Einführung

BackResto ist die HACCP-Compliance-App, die Teams in der Gastronomie während des Betriebs ausfüllen: Wareneingangskontrollen, Gar- und Kühltemperaturen, Reinigungspläne, Etiketten. Die Partner-API übergibt diese Aufzeichnungen an die Software, die Ihre Kunden ohnehin schon betreiben — ein ERP, ein Lieferantenportal, ein Qualitäts-Dashboard, einen KI-Assistenten.

Es ist eine nur lesende HTTP-API mit einem Authentifizierungsverfahren und einer Fehlerstruktur, von Anfang bis Ende beschrieben durch ein OpenAPI-Dokument, das Sie direkt in einen Client-Generator oder in eine LLM-Tool-Definition laden können. Dieselben Daten sind über MCP unter https://api.backresto.com/mcp erreichbar, mit demselben Schlüssel und denselben Rechten, wenn Sie lieber Fragen stellen als einen Client schreiben wollen.

Das Restaurant entscheidet, was Sie sehen

Das ist der Teil, den man zweimal lesen sollte, weil er sich von den meisten APIs unterscheidet, die Sie integrieren werden.

Es gibt keine Registrierung. Ein Schlüssel wird von Hand ausgestellt, begrenzt auf benannte Restaurants und benannte Berechtigungen, und erst dann, wenn die betreffenden Restaurants zugestimmt haben. Fragen Sie per E-Mail nach einem — Einen Schlüssel erhalten ist die Checkliste — und er trifft bei dem technischen Kontakt ein, den Sie nennen.

Die Folge ist eine harte: Ein Schlüssel erreicht die Restaurants, für die er zugewiesen wurde, und nichts sonst. restaurant-3 taucht nicht auf, weil restaurant-1 und restaurant-2 auf demselben Schlüssel liegen, und keine Anfrage, die Sie stellen können, erweitert das. Einen Standort hinzuzufügen ist ein weiteres Gespräch, mit den Leuten, deren Daten es sind.

Der Vorteil eines kleinen manuellen Schritts ist, dass der Widerruf ebenso direkt ist: eine E-Mail, und der Schlüssel ist bei der nächsten Anfrage tot.

Was in den Daten steckt

Lieferungen sind eine entworfene Ressource; Collections geben Ihnen den Datensatz so, wie die App ihn hält, in einem einzigen generischen Umschlag. Das Zweite ist der Weg, auf dem ein Modul diese API in der Woche erreicht, in der es erscheint, und nicht erst im Quartal danach.

Alles davon ist nur lesbar. Nichts, was ein Partnerschlüssel aufrufen kann, schreibt in die Aufzeichnungen eines Restaurants — die App ist der Ort, an dem Compliance-Daten entstehen, durch die Person, die dafür geradesteht.

Was hier noch nicht ist

Über die Ränder deutlich zu sein, spart Ihnen einen Nachmittag:

• Keine rückwirkende Nachlieferung. Die Datensätze eines Restaurants werden für diese API ab dem Moment sichtbar, in dem die Erfassung für dieses Restaurant eingeschaltet wird. Was davor war, liegt in der App, nicht hier. Nehmen Sie einen leeren Zeitraum nicht als Beweis, dass nichts passiert ist — siehe Support.
• Keine Schreibzugriffe, keine Webhooks. Sie fragen ab. Wenn Sie Push brauchen, sagen Sie es uns; das ist eine Frage der Nachfrage, nicht des Prinzips.
• Kein inkrementeller Cursor auf Collections. Eine Collection aufzufrischen heißt, sie erneut zu durchlaufen und über id abzugleichen. Lieferungen, die unveränderlich sind, nehmen stattdessen einen Zeitraum.
• Keine OAuth-Anmeldung. Jeder Client authentifiziert sich mit einem Schlüssel, auch über MCP. Tools, die auf einer Anmeldeseite bestehen, können sich noch nicht verbinden.

Basis-URLs

Ein Schlüssel wird in einer Umgebung eingerichtet und bedeutet in den anderen nichts: Schlüssel, Zuweisungen und Daten gelten pro Umgebung. Alles Folgende verwendet den Produktions-Origin.

Bereit? Machen Sie Ihren ersten Aufruf.