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.

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.json

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

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.

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)