OAC Open Standard
Eine anbieterneutrale JSON-Spezifikation für Restaurantdaten. Ein einziger Endpunkt liefert alles, was Sie zum Anzeigen, Routen oder Reservieren benötigen.
Schnelles Beispiel
curl https://www.openalacarte.com/api/standard/v1/restaurants/<slug>
Keine Authentifizierung. 5 Minuten am Edge zwischengespeichert. CORS offen — vom Browser aus aufrufbar.
Was die Antwort enthält
restaurant.*
Identität, Kontakt, Währung, Adresse mit lat/lng, Öffnungszeiten pro Tag, was sie akzeptieren (Reservierungen / Lieferung / Abholung).
menu.sections[].items[]
Die vollständige aktive Speisekarte — Name, Beschreibung, Preis, Währung, Allergene, Bild — gruppiert nach Abschnitt.
spec + fetched
Versionierter Umschlag (`openalacarte.standard/v1`) + ISO-Zeitstempel, damit nachgelagerte Caches wissen, was sie haben.
Stabile IDs
Der `slug` des Restaurants ist die kanonische Kennung. Wir brechen keine URLs; umbenannte Slugs liefern 301-Weiterleitungen.
Versionierung
SemVer auf URL-Ebene. v1.*-Ergänzungen sind abwärtskompatibel (neue Felder, niemals entfernt/umbenannt). Inkompatible Änderungen wandern nach /v2/ mit einer Überschneidung von 12 Monaten.
Veraltungen werden im Entwickler-Änderungsprotokoll dieser Seite + über den Antwort-Header Deprecation angekündigt.
Wer das nutzt
Der Open Standard wird genutzt von:
- Unserem eigenen JSON-LD-Generator für Google Maps Reserve + Apple Business Connect
- Einbettbare Widgets (/restaurants/[slug]) — gleiche Nutzlast, gerendertes HTML
- (Zukünftig) Drittanbieter-Integratoren — DoorDash, Uber Eats, Tock — wenn sie kanonische OAC-Daten möchten
Bauen Sie darauf auf? Schreiben Sie an devs@openalacarte.com und wir listen Sie hier auf.
Warum „Open“ Standard?
Weil die Spezifikation dokumentiert + versioniert + stabil ist. Wir verpflichten uns, sie nicht zu brechen. Wenn Sie Code gegen /v1/ schreiben, funktioniert dieser Code weiter — selbst wenn OAC pivotiert, selbst wenn wir übernommen werden.