Erste Schritte
Glasswise stellt zwei maschinelle Schnittstellen über der E-Label-Fläche bereit:
- Die REST API unter
https://public-api.glasswise.eu/v1ist der Vertrag, gegen den Partner-Integrationen entwickeln. Sie deckt die Workspaces (Weingüter) ab, denen du angehörst, Brands, Labels mit ihren Bestandteilen und Flaschenformaten, Marketing-QR-Codes und die schreibgeschützten Referenzkataloge. - Der MCP-Server unter
https://mcp.glasswise.eu/mcpstellt dieselben Operationen als Tools für MCP-Clients wie Claude Code bereit. Der MCP-Server ist selbst ein Client der API.
Ein Label ist das digitale Weinetikett hinter dem QR-Code auf der Flasche: Identität, Zutaten, Rebsorten, Zertifizierungen, Verpackungen und Übersetzungen, plus ein Flaschenformat pro GTIN. Ein Marketing-QR-Code ist ein zweiter, bearbeitbarer Code, der auf ein Ziel deiner Wahl weiterleitet.
Labeländerungen und gemeinsame Weindaten
Abschnitt betitelt „Labeländerungen und gemeinsame Weindaten“Ein Wein kann gemeinsame Texte und Listen für ein oder mehrere Labels liefern. Flaschenformate gehören zu einem Label und enthalten Füllmenge und Kennungen. Die bestehenden API-Operationen bearbeiten Labels und Formate; die Weinverwaltung ist nicht Teil dieses API-Vertrags.
Wenn du eine Labelliste ersetzt, wird sie unabhängig von der Liste des Weins. Beim Ersetzen einer Übersetzung bleiben bestehende Einstellungen für abweichende Labeltexte erhalten. Weggelassene Textfelder werden null. Eine Textänderung ohne eigene Abweichung kann den Wein aktualisieren, wenn er nur ein Label hat. Lies vor dem Ersetzen von Inhalten das Verhalten bei Schreibzugriffen.
Erster Request
Abschnitt betitelt „Erster Request“Jeder Aufruf unter /v1 braucht ein Bearer-Token; siehe Authentifizierung. Die einzige Ausnahme ist das OpenAPI-Dokument selbst:
curl https://public-api.glasswise.eu/v1/openapi.jsonMit einem Token listest du die Workspaces, denen dein Konto angehört:
curl -H "Authorization: Bearer <token>" https://public-api.glasswise.eu/v1/workspacesDasselbe Token funktioniert auf dem MCP-Server. MCP verbinden beschreibt die Client-Einrichtung und die Tool-Liste.
Wo was liegt
Abschnitt betitelt „Wo was liegt“| Fläche | Basis-URL |
|---|---|
| REST API | https://public-api.glasswise.eu/v1 |
| OpenAPI-Dokument | https://public-api.glasswise.eu/v1/openapi.json |
| MCP-Server | https://mcp.glasswise.eu/mcp |
| Liveness-Probe | https://public-api.glasswise.eu/healthz (ohne Auth) |