Code
Partner-API v1, der Shop-Vertrag auf @delieta/shop-runtime und das Aktualisierungssignal — hier beginnt deine Integration.
Dieser Bereich ist für alle, die Delieta mit einem Shop, einer Kasse oder dem eigenen Backend verbinden. Das Firmenpanel beschreiben die Funktionen.
Was hier steht
Jede der drei Seiten beantwortet eine Frage.
| Frage | Seite |
|---|---|
| Wie lese ich das Menü, nehme eine Bestellung aus dem Shop an, lege eine Bestellung aus der Kasse an, nehme eine Reservierung oder eine Catering-Anfrage an? | Partner-API |
Wie baue ich einen Shop auf @delieta/shop-runtime, der kein Geheimnis preisgibt? | Shop-Vertrag |
| Benachrichtigt Delieta meinen Server, wenn sich ein Status ändert? | Webhooks — nein, prüfe den Status per GET. Der Shop bekommt nur ein signiertes Aktualisierungssignal. |
Derselbe Vertrag in maschinenlesbarer Form: GET /api/v1/openapi (ohne Schlüssel, nach IP begrenzt). Diese Seiten werden gegen dieses Dokument geprüft.
Regeln für alle Seiten
Der Schlüssel bezeichnet die Firma. Die Felder tenantSlug und companyId im Body werden ignoriert.
Geld sind ganze Grosze. 3200 sind 32,00 zł. v1 kennt keine andere Währung als PLN.
Fehler sind RFC 9457 application/problem+json. Erkenne den Fehler am Feld code, nie an title.
Ein veröffentlichbarer Schlüssel hat genau catalog:read und checkout:create: Er liest Menü und Shop-Einstellungen und nimmt eine Shop-Bestellung, eine Reservierung und eine Anfrage an. Ein geheimer Schlüssel legt Kassenbestellungen an und berechnet ETA. Beide Schlüssel bleiben auf dem Server, nie im Browser — der Shop-Vertrag hilft dir dabei.
Erste Integration Schritt für Schritt: Für Entwickler.