Zum Inhalt springen

Erste Schritte

Glasswise stellt zwei maschinelle Schnittstellen über der E-Label-Fläche bereit:

  • Die REST API unter https://public-api.glasswise.eu/v1 ist 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/mcp stellt 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.

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.

Jeder Aufruf unter /v1 braucht ein Bearer-Token; siehe Authentifizierung. Die einzige Ausnahme ist das OpenAPI-Dokument selbst:

Terminal-Fenster
curl https://public-api.glasswise.eu/v1/openapi.json

Mit einem Token listest du die Workspaces, denen dein Konto angehört:

Terminal-Fenster
curl -H "Authorization: Bearer <token>" https://public-api.glasswise.eu/v1/workspaces

Dasselbe Token funktioniert auf dem MCP-Server. MCP verbinden beschreibt die Client-Einrichtung und die Tool-Liste.

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)