Darstellung
Speisekarten-API für Webagenturen
Diese Seite richtet sich an Webagenturen und Entwickler, die die Speisekarte und das Wochenmenü eines Betriebs auf dessen Website zeigen. Die Schnittstelle ist öffentlich, nur lesend und liefert JSON. Der Betrieb schaltet sie selbst frei, siehe Karte auf der Website.
Zugang
Der Betrieb kopiert die vollständigen Adressen aus dem Backoffice (Einstellungen → Auftritt → Speisekarte online, Abschnitt Karte auf Ihrer Website). Die Adresse der Karte hat die Form:
https://…/api/public/v1/menu/<schlüssel>Der Schlüssel ist kein Geheimnis. Er kennzeichnet den Betrieb und steht bei Abrufen aus dem Browser im Klartext im Code der Seite. Der Betrieb kann ihn jederzeit erneuern; die alten Adressen liefern dann sofort 404.
Endpunkte
Im Folgenden steht {Adresse} für die kopierte Adresse der Karte. Alle Endpunkte sind GET, ohne Anmeldung und ohne Cookies.
| Endpunkt | Inhalt |
|---|---|
GET {Adresse} | Betrieb und gesamte Karte: Kategorien mit ihren Gerichten |
GET {Adresse}/weekly?week=2026-W46 | Eine Woche des Wochenmenüs; ohne week die laufende Woche |
GET {Adresse}/weekly/weeks | Veröffentlichte Wochen ab der laufenden, zum Blättern |
Parameter
| Parameter | Gilt für | Bedeutung |
|---|---|---|
lang | Karte, weekly | Sprachcode, etwa en. Erlaubt sind nur die Sprachen des Betriebs (mehrere Sprachen je nach Tarif). Eine unbekannte Sprache fällt auf die Basissprache zurück. Die Antwort nennt die benutzte Sprache als language und alle möglichen als languages. |
week | weekly | ISO-Woche im Format 2026-W46. Ohne Angabe die laufende Woche. |
Die Sprache wird nur über lang gewählt, der Header Accept-Language wird nicht beachtet. Sonst ließen sich die Antworten nicht zwischenspeichern.
Karte
Die Antwort von GET {Adresse} im Überblick (gekürzt):
json
{
"apiVersion": 1,
"generatedAt": "2026-11-12T10:15:00+01:00",
"location": {
"name": "Rinderwahn",
"currency": "EUR",
"timezone": "Europe/Vienna",
"language": "de",
"languages": ["de", "en"],
"links": { "digitalMenu": "https://…/m/…", "takeawayOrder": null }
},
"cards": [
{ "id": "cm2…", "name": "Speisen", "kind": "FOOD", "sort": 0 }
],
"categories": [
{
"id": "cm3…",
"name": "Mittagskarte",
"sort": 0,
"cardId": "cm2…",
"visible": {
"now": false,
"schedule": {
"weekly": [{ "days": ["mon", "tue", "wed", "thu", "fri"], "from": "11:00", "to": "14:30" }],
"dates": [{ "date": "2026-12-24", "closed": true, "windows": [] }],
"nextChange": "2026-11-13T11:00:00+01:00"
}
},
"takeaway": null,
"dishes": [
{
"id": "cm4…",
"name": "Tafelspitz",
"description": "mit Apfelkren und Rösti",
"story": null,
"price": { "amount": 2450, "formatted": "€ 24,50" },
"allergens": [{ "code": "G", "label": "Milch/Laktose" }],
"badges": [{ "code": "klassiker", "label": "Klassiker" }],
"image": {
"url": "https://…/api/uploads/3f…a1.webp",
"thumbUrl": "https://…/api/uploads/3f…a1_t.webp",
"focus": { "x": 0.5, "y": 0.4 }
},
"available": { "now": true, "schedule": null },
"takeaway": null,
"priceFrom": { "amount": 1650, "formatted": "€ 16,50" },
"variants": [
{ "id": "cm7…", "name": "klein", "price": { "amount": 1650, "formatted": "€ 16,50" }, "available": true, "takeaway": null, "allergens": [], "badges": [] },
{ "id": "cm8…", "name": "groß", "price": { "amount": 2450, "formatted": "€ 24,50" }, "available": true, "takeaway": null, "allergens": [], "badges": [] }
],
"optionGroups": [
{
"id": "cm9…",
"name": "Beilage",
"min": 1,
"max": 1,
"options": [
{ "id": "cma…", "name": "Rösti", "price": { "amount": 0, "formatted": "€ 0,00" }, "maxQty": 1, "default": true, "available": true, "allergens": [] }
]
}
],
"drink": null,
"extras": [{ "id": "cm5…", "name": "Extra Kren", "price": { "amount": 150, "formatted": "€ 1,50" } }],
"pairingDishId": null
}
]
}
]
}Felder der Antwort
| Feld | Bedeutung |
|---|---|
apiVersion | Version des Formats, derzeit 1. |
generatedAt | Stand der Antwort, ISO mit Offset der Zeitzone des Betriebs. |
location.name, currency, timezone | Name, Währung (ISO-Code) und Zeitzone des Betriebs. |
location.language, languages | Sprache dieser Antwort; alle Sprachen, die lang annimmt (die erste ist die Basissprache). |
location.links.digitalMenu | Adresse der digitalen Karte (Karten-QR), oder null. |
location.links.takeawayOrder | Bestell-Link zum Abholen; null ohne Takeaway. |
cards[] | Karten (Überkategorien) mit id, name, kind (FOOD, DRINKS, WINE oder OTHER) und sort. Leer, wenn der Betrieb keine Karten nutzt. |
categories[] | Kategorien in der Reihenfolge der Karte. |
Kategorie
| Feld | Bedeutung |
|---|---|
id, name, sort | Kennung, übersetzter Name, Position. |
cardId | Kennung der Karte, zu der die Kategorie gehört, oder null. |
visible | Zeitschalter: ist die Kategorie jetzt sichtbar? |
takeaway | Zeitschalter für die Abholung; null, wenn der Betrieb kein Takeaway anbietet. |
dishes[] | Gerichte der Kategorie, in der Reihenfolge der Karte. |
Die Liste enthält alle Kategorien, die die Gäste-App zeigt, und zusätzlich alle zeitgesteuerten Kategorien, auch wenn sie gerade aus sind. Von Hand ausgeblendete Kategorien ohne Zeitsteuerung fehlen.
Gericht
| Feld | Bedeutung |
|---|---|
id, name, description, story | Kennung, übersetzter Name, Beschreibung, optionale Geschichte zum Gericht (null möglich). |
price | Preis der Grundvariante (der ersten Variante), siehe Preise. |
priceFrom | Günstigster Preis, nur wenn die Varianten verschieden viel kosten; sonst null. Zum Anzeigen als „ab …“. |
variants[] | Varianten mit eigenem Preis, siehe Varianten. Die erste ist die Grundvariante. |
optionGroups[] | Optionsgruppen (Pflichtwahl oder Extras), siehe Optionsgruppen. |
drink | Getränkeangaben, siehe Getränkeangaben; null, wenn keine gepflegt sind. |
allergens[], badges[] | Allergene und Merkmale als code (stabil) und label (übersetzt). |
image | Bild oder null. url ist eine absolute Adresse; thumbUrl die verkleinerte Fassung oder null; focus der Fokuspunkt { x, y } mit Werten von 0 bis 1 von links oben, oder null für die Mitte. |
available | Zeitschalter: bestellbar oder nicht verfügbar. Nicht verfügbare Gerichte bleiben in der Liste. |
takeaway | Zeitschalter für die Abholung; null ohne Takeaway. |
extras[] | Die flache Liste der Zusätze mit id, name und price, wie bisher. Neue Websites verwenden besser optionGroups. |
pairingDishId | Kennung des empfohlenen Begleiters (ein Gericht derselben Karte) oder null. |
Varianten
Jede Variante hat id, name, price, available, takeaway, allergens[] und badges[]. available ist false, wenn nur diese Variante ausverkauft ist; das Gericht bleibt in der Liste. takeaway sagt, ob sie auch zum Mitnehmen angeboten wird, und ist null ohne Takeaway. Beides sind einfache Wahrheitswerte, keine Zeitschalter. allergens und badges enthalten, was nur für diese Variante gilt, zusätzlich zu den Angaben des Gerichts. Jedes Gericht hat mindestens eine Variante; hat es nur einen Preis, ist der name der Grundvariante leer.
Optionsgruppen
Eine Optionsgruppe hat id, name, min und max: So viele Optionen muss der Gast mindestens und darf er höchstens wählen; max ist null, wenn beliebig viele erlaubt sind. Bei min ab 1 ist es eine Pflichtwahl, bei 0 sind es freiwillige Extras. Jede Option hat id, name, price (Aufpreis), maxQty (wie oft sie gewählt werden darf), default (vorgewählt), available (false, wenn heute nicht da) und allergens[].
Getränkeangaben
drink enthält bei Getränken producer, vintage, grapes, origin und abv, der Alkoholgehalt in % vol. Jede Angabe kann null sein. Sind gar keine gepflegt, ist drink selbst null.
Preise
Jeder Preis kommt als Objekt mit zwei Feldern:
| Feld | Beispiel | Verwendung |
|---|---|---|
amount | 1650 | Betrag in Cent, zum Rechnen. |
formatted | "€ 16,50" | Fertig formatiert in Sprache und Währung des Betriebs, zum Anzeigen. |
Allergene und Merkmale
Allergene und Merkmale haben einen stabilen code, auf den Sie sich verlassen können, und ein übersetztes label zur Anzeige. Die Labels gibt es derzeit in Deutsch und Englisch; für andere Sprachen steht das englische Label.
Zeitschalter
Alles, was sich zeitlich steuern lässt, kommt in derselben Form:
json
{
"now": true,
"schedule": {
"weekly": [{ "days": ["mon", "tue"], "from": "11:00", "to": "14:30" }],
"dates": [{ "date": "2026-12-24", "closed": true, "windows": [] }],
"nextChange": "2026-11-13T11:00:00+01:00"
}
}Er kommt an diesen Stellen vor:
| Feld | Steuert |
|---|---|
category.visible | Kategorie sichtbar |
dish.available | Gericht bestellbar oder nicht verfügbar |
category.takeaway, dish.takeaway | Zum Mitnehmen; null ohne Takeaway |
Wochenmenü visible | Wochenmenü sichtbar |
now ist der Wert für den Augenblick der Anfrage in der Zeitzone des Betriebs, so wie ihn auch die Gäste-App zeigt. schedule ist nur gesetzt, wenn eine Zeitsteuerung mit Regeln wirkt; sonst ist es null.
now | schedule | Bedeutung |
|---|---|---|
true | null | Dauerhaft an. |
false | null | Von Hand aus; bei Gerichten: nicht verfügbar. |
true | gesetzt | Gerade im Zeitfenster; nextChange nennt den Zeitpunkt, an dem es endet. |
false | gesetzt | Außerhalb des Fensters; nextChange nennt den Zeitpunkt, ab dem es gilt. |
Felder von schedule:
| Feld | Bedeutung |
|---|---|
weekly[] | Wochenregeln als Fenster mit days (mon bis sun), from und to im Format HH:MM. to ist exklusiv, 24:00 bedeutet bis Mitternacht. |
dates[] | Regeln für einzelne Daten der nächsten 60 Tage. An so einem Datum gelten nur diese Fenster. closed: true heißt ganztägig aus, dann ist windows leer. |
nextChange | Nächster Wechsel von now, ISO mit Offset. null, wenn in den nächsten 14 Tagen keiner ansteht. |
Wochenmenü
GET {Adresse}/weekly liefert eine Woche (gekürzt):
json
{
"apiVersion": 1,
"generatedAt": "2026-11-12T10:15:00+01:00",
"offered": true,
"language": "de",
"week": { "id": "2026-W46", "from": "2026-11-09", "to": "2026-11-15" },
"visible": { "now": true, "schedule": null },
"days": [
{
"date": "2026-11-12",
"weekday": "thu",
"isToday": true,
"combos": [
{
"id": "cm6…",
"name": "Menü 1",
"price": { "amount": 1290, "formatted": "€ 12,90" },
"badges": [],
"available": true,
"soldOut": false,
"courses": [
{ "type": "SOUP", "label": "Vorweg", "text": "Karotte-Ingwer", "allergens": [], "surcharge": null, "deselect": null },
{ "type": "MAIN", "label": "Hauptgang", "text": "Gebackenes Hendl", "allergens": [{ "code": "A", "label": "Gluten" }], "surcharge": null, "deselect": { "amount": 200, "formatted": "€ 2,00" } }
]
}
]
}
]
}| Feld | Bedeutung |
|---|---|
offered | false, wenn das Wochenmenü nicht zum Tarif des Betriebs gehört. Die Antwort ist trotzdem 200, ohne Woche und ohne Tage. So lässt sich „kein Tarif“ von „falscher Schlüssel“ unterscheiden. |
week | Die Woche mit id, from und to. null, wenn die gewünschte Woche nicht veröffentlicht ist oder außerhalb des Bereichs liegt. Abrufbar sind die laufende Woche und bis zu 52 Wochen voraus; Entwürfe erscheinen nie. |
visible | Zeitschalter für das Wochenmenü insgesamt. |
days[] | Nur die aktivierten Tage: date, weekday, isToday, combos[]. |
combos[].available | false, wenn der Betrieb die Kombination von Hand auf „nicht verfügbar“ gesetzt hat. |
combos[].soldOut | true, wenn das Kontingent erschöpft ist. |
combos[].courses[] | Gänge. |
Beide Sperren bleiben in der Liste; die Website entscheidet, wie sie sie zeigt.
Gang
| Feld | Bedeutung |
|---|---|
type | Fester Code: SOUP, MAIN, DESSERT, OPTIONAL oder CUSTOM. |
label | Übersetzte Bezeichnung, bei CUSTOM die eigene des Betriebs. |
text | Inhalt des Gangs. |
allergens[] | Allergene als code und label. |
surcharge | Aufpreis eines optionalen Gangs, oder null. |
deselect | Abzug, wenn der Gast den Gang abwählt, oder null, wenn er nicht abwählbar ist. |
Veröffentlichte Wochen
GET {Adresse}/weekly/weeks liefert offered und weeks[] mit id, from und to, nur veröffentlichte Wochen ab der laufenden. Damit lässt sich ein Blättern aufbauen; die id übergeben Sie als week.
Fehler
| Status | Wann | Antwort |
|---|---|---|
404 | Schlüssel unbekannt, Freigabe aus, Website nicht erlaubt, digitale Karte nicht gebucht, Betrieb gesperrt | {"code":"not_found",…}, in allen Fällen dieselbe Antwort |
422 | week hat nicht das Format 2026-W46 | {"code":"validation_error",…} |
429 | Zu viele Abrufe | {"code":"rate_limited",…} |
Die 404 ist absichtlich einheitlich. Aus ihr lässt sich nicht ablesen, ob ein Schlüssel existiert. Prüfen Sie bei einer 404 zuerst, ob die Freigabe im Backoffice eingeschaltet und gespeichert ist, ob der Schlüssel noch gilt und ob die Website unter Erlaubte Websites steht.
Zwischenspeicher
Antworten tragen Cache-Control: public, max-age=60, stale-while-revalidate=300 und einen ETag. Eine Änderung im Backoffice ist spätestens nach einer Minute in den Daten. now kann deshalb bis zu 60 Sekunden alt sein; generatedAt nennt den Stand. Fragen Sie nicht häufiger als einmal pro Minute und Seite ab; Abrufe sind je Absender und Schlüssel begrenzt.
CORS
Ist unter Erlaubte Websites nichts eingetragen, antwortet die Schnittstelle mit Access-Control-Allow-Origin: *. Ist eine Liste eingetragen, gibt sie nur der passenden Herkunft ihre eigene Origin zurück (mit Vary: Origin); andere Herkunft bekommt die 404. Anfragen ohne Origin-Header, etwa vom Server oder beim Bau einer statischen Seite, werden immer beantwortet.
Rufen Sie nur mit einfachen GET-Anfragen ohne eigene Header ab, also ohne Authorization und ohne eigenes Content-Type. Sonst schickt der Browser vorab eine Preflight-Anfrage (OPTIONS), und die beantwortet die Schnittstelle nicht.
Versionierung
Die Version steht in der Adresse (/v1/) und als apiVersion in der Antwort. Das Format von v1 bleibt stabil: Felder werden nicht umbenannt oder entfernt. Es können aber neue Felder dazukommen. Ignorieren Sie deshalb unbekannte Felder und setzen Sie nicht voraus, dass ein Objekt genau die hier genannten Felder hat. Brechende Änderungen gäbe es nur unter /v2/.
Beispiel
js
const base = 'https://…/api/public/v1/menu/<schlüssel>';
const res = await fetch(`${base}?lang=de`);
if (!res.ok) throw new Error(`Karte nicht abrufbar: ${res.status}`);
const menu = await res.json();
for (const category of menu.categories) {
if (!category.visible.now) continue; // zeitgesteuert, gerade aus
console.log(category.name);
for (const dish of category.dishes) {
const note = dish.available.now ? '' : ' (nicht verfügbar)';
console.log(` ${dish.name} ${dish.price.formatted}${note}`);
}
}