REST-API
Schlüssel anlegen, Rechte vergeben, Zugriffe widerrufen — und die vollständige Referenz jeder Route: Zweck, Parameter, Anfrage- und Antwortbeispiel, mögliche Fehler, Codebeispiele in acht Sprachen.
Grundlagen
Der erste Aufruf in fünf Minuten
Schlüssel anlegen, Rechte setzen, die Stammdaten des Betriebs abrufen — in acht Sprachen, vom fertigen Befehl bis zur vollständigen Antwort.
Für EntwicklerAnmeldung mit dem Token
Wie ein Schlüssel aufgebaut ist, welche Rechte er tragen kann, warum er im Query-String sofort widerrufen wird — und wann er über Nacht seine Rechte verliert.
Für EntwicklerDie Form jedes Fehlers
Ein Körper, ein Aufbau, ein geschlossener Katalog von Kennungen — und warum in `message` nie eine rohe Datenbankmeldung steht.
Für EntwicklerRatenbegrenzung: wie viel, wovon, und was bei 429 zu tun ist
Fünf Eimer, drei Kopfzeilen und ein Stundenkontingent für Gästedaten — mit fertigem Wiederholversuch in vier Sprachen.
Für EntwicklerBlätterung: der Zeiger statt der Seitenzahl
Warum es kein `?page=` gibt, wie `nextCursor` benutzt wird, welche zwei Umschläge es gibt — und wie ein inkrementeller Abgleich aussieht, der nichts überspringt.
Für EntwicklerIdempotenz: derselbe Aufruf, dasselbe Ergebnis
Wie `Idempotency-Key` einen Netzabbruch von einer zweiten Buchung trennt, wo er Pflicht ist und was bei Wiedergabe, Kollision und laufender Anfrage passiert.
Für EntwicklerPrüfmodus und optimistisches Sperren
`X-TacticTable-Dry-Run: 1` rechnet alles durch, ohne etwas zu hinterlassen — und `ETag`/`If-Match` verhindert, dass Ihr Schreibvorgang eine fremde Änderung überfährt.
Für EntwicklerVersionierung: was sich ändern darf und was nicht
Die Fassung steht im Pfad. Was additiv ist, kommt jederzeit; was bricht, bekommt eine neue Fassung — und wie man eine Anbindung schreibt, die beides übersteht.
Für Entwickler
Reservierungen
Reservierungen lesen, anlegen und ändern
Das Reservierungsbuch: Liste mit zwanzig Filtern, Einzelabruf mit ETag, Anlegen durch dieselbe Torwache wie das Widget und Teiländerung ohne Datenverlust.
Für EntwicklerStatus wechseln: bestätigen, stornieren, No-Show melden
Die eine Route, über die eine Reservierung ihren Zustand ändert — hinter einer eigens vergebenen Handlung, weil ein No-Show Geld einzieht.
Für EntwicklerVerfügbarkeit: welche Uhrzeiten anbieten?
Dieselbe Rechnung wie im Buchungs-Widget — damit eine Telefonanlage genau die Zeiten anbietet, die der Gast online auch sähe.
Für EntwicklerTischbelegung: Laufkundschaft und „Tisch frei"
Wer sitzt gerade wo — ohne einen einzigen personenbezogenen Wert, damit ein Bildschirm im Gastraum keinen Schlüssel für die Gästeliste braucht.
Für Entwickler
Gäste
Gästekartei lesen, anlegen und pflegen
Die Stammdaten der Gäste: exakte Suche statt Auskunftei, drei Sichtbarkeitsstufen, Merkmale additiv ändern und der Newsletter-Zustand als eine einzige verlässliche Frage.
Für EntwicklerBesuchshistorie eines Gastes
Welche Reservierungen zu einem Gast gehören — und warum dieser eine Endpunkt zwei Rechte verlangt.
Für EntwicklerAuskunft und Löschbegehren (DSGVO)
Art. 15 und 20 als vollständige Auskunft, Art. 17 als Anonymisierung — dreifach gebremst, weil beides unumkehrbar oder hochverdichtet ist.
Für Entwickler
Betrieb
Betrieb und Marke
Name, Anschrift, Zeitzone — und Logo, Farben, Schriften sowie die Links, die eine Bewertungsanfrage braucht.
Für EntwicklerÖffnungszeiten
Die Zeitsätze des Betriebs mit ihren sieben Tagen, zwei Fenstern je Tag, Saison und Vorrang — inklusive der Falle „Schluss vor Beginn".
Für EntwicklerBereiche und Tische
Gastraum, Terrasse, Stüberl — mit Hierarchie und Saison. Und die Tische mit Kapazität und Tischplan-Geometrie, ohne einen einzigen personenbezogenen Wert.
Für EntwicklerSpeisekarte: Karten, Gänge, Gerichte
Der Endpunkt für eine fremde Website und einen Bildschirm im Lokal — mit Allergenen, Preisen in Cent und ohne die Kalkulation des Hauses.
Für EntwicklerSperren: Betriebsurlaub aus dem Kalender
Der einzige Schreibweg der Stammdaten und die einzige Löschoperation der ganzen API — mit der Zahl, die verhindert, dass ein Abgleich still den Verkauf abschaltet.
Für Entwickler
Warenwirtschaft
Lieferanten
Lesen, anlegen und ändern — mit Volltextsuche über Firma, Ansprechpartner, Stadt und UID. Kein Löschen, und der Grund steht daneben.
Für EntwicklerWaren: Einkaufspreise, Gebinde und Mindestmengen
Der Warenstamm mit Einkaufspreisen — das Betriebsgeheimnis des Hauses. Lesen, anlegen, ändern, nach Unterdeckung filtern und per Scannercode auflösen.
Für EntwicklerRezepte: Zutaten, Schritte und die Nachkalkulation
Rezepte mit Zutatenliste und Zubereitungsschritten — und die gerechnete Zutatensumme in Cent, die die Nachkalkulation trägt.
Für EntwicklerLager und Bestand: die Inventur
Lager lesen, Bestände je Lager lesen und ABSOLUT setzen — warum das ein `PUT` ist, warum der Schlüssel Pflicht ist, und was es hier bewusst nicht gibt.
Für Entwickler