QR-Codes aus einer Software oder einem KI-Agenten erstellen
Mit einem Pro- oder Entreprise-Plan lässt sich QR Suisse, ein Generator für dynamische QR-Codes der Skyday Sàrl, über eine REST-API steuern: QR-Code erstellen (Link oder Kontaktkarte), Ziel ändern, Bild als PNG oder SVG herunterladen und Statistiken lesen. Ein KI-Agent nutzt sie mit einem API-Schlüssel, den Sie ihm über seine Konfiguration geben. Um die API kennenzulernen, kann sich der Agent mit dem öffentlichen MCP-Server von QR Suisse verbinden, der die Dokumentation nur zum Lesen bereitstellt.
Was die API kann
- Einen QR-Code vom Typ Link (URL) oder Kontaktkarte (vCard) mit einer Bezeichnung erstellen.
- Sein Ziel nach dem Druck ändern, ihn archivieren oder reaktivieren.
- Sein Bild als SVG (für den Druck) oder PNG herunterladen.
- Die Zahl der Scans lesen, gesamt und pro Tag.
- Eine im Dashboard erstellte Stilvorlage anwenden.
- Die QR-Codes des Kontos auflisten und durchsuchen.
Die vollständige Dokumentation und die OpenAPI-Spezifikation sind öffentlich: https://www.qrsuisse.ch/openapi.json.
Drei Schritte zur Integration
- Einen API-Schlüssel im Dashboard erstellen. Nur ein Mitglied mit der Berechtigung «Verwalter der API-Schlüssel» (oder Administrator) kann das, und es wählt die Rechte des Schlüssels: erstellen, lesen, ändern, löschen, Statistiken lesen.
- Den Schlüssel Ihrem Programm oder Agenten über die Konfiguration geben, zum Beispiel als Umgebungsvariable. Fügen Sie ihn nie in einen Chat ein.
- Die API aufrufen, über HTTPS, mit dem Header
Authorization: Bearer <Schlüssel>.
Ein KI-Agent, der die Dokumentation kennt: der MCP-Server
Mit dem öffentlichen MCP-Server von QR Suisse kann ein kompatibler Assistent (Claude Code, Visual Studio Code und andere MCP-Clients) die Dokumentation durchsuchen und jede Seite lesen: Anleitungen, Preise und eine Seite pro API-Operation. Er hat zwei Werkzeuge, nur zum Lesen: qr_suisse_search_docs und qr_suisse_get_page.
- Er hat keinen Zugriff auf ein Konto und erstellt keine QR-Codes.
- Er verlangt weder Registrierung noch Schlüssel.
- Er nimmt 60 Anfragen pro Minute und Adresse an.
Adresse und Konfiguration für jeden Client stehen auf der Seite MCP-Server.
Grenzen, die Sie vor dem Start kennen sollten
- Die API ist den Plänen Pro und Entreprise vorbehalten.
- Jeder Plan erlaubt eine Zahl aktiver Schlüssel: 1 mit Pro, 10 mit Entreprise.
- Erstellungen per API sind pro Kalendermonat begrenzt: 5 mit Pro, 100 mit Entreprise, danach Pakete mit Einmalkauf. Ändern, Lesen oder Herunterladen eines QR-Codes verbraucht nichts.
- Die Dokumentation für Agenten ist auf Englisch; die OpenAPI-Spezifikation gibt es auch auf Deutsch.
Häufig gestellte Fragen
Kann ein KI-Agent selbst einen QR-Code bei QR Suisse erstellen?
Gibt der MCP-Server Zugriff auf meine QR-Codes?
Ist die API im Gratis-Plan verfügbar?
Kann man einen bereits gedruckten QR-Code per API ändern?
Weitere Anwendungsfälle
Statischer oder dynamischer QR-Code: was wählen?
Was jede Art kann, wovon sie abhängt und welche zu einem gedruckten Medium passt.
QR-Code für Visitenkarten
Ihre Kontaktdaten bleiben auf bereits gedruckten Karten aktuell.
QR-Codes für Flyer und Plakate
Ein QR-Code pro Version, nach dem Druck korrigierbar, für Agenturen und Druckereien.