QR-Code API: wie man die Generierung in eine Web-App integriert
Anleitung mit curl-Beispielen zum Erstellen, Verwalten und Herunterladen dynamischer QR-Codes per REST API
Die REST API von codigo-qr.es ermöglicht es, QR-Codes direkt aus Ihrer Anwendung zu generieren, aktualisieren und zu analysieren, ohne das Dashboard zu verwenden. Sie können die QR-Erstellung für Rechnungen, digitale Speisekarten oder Veranstaltungstickets automatisieren und das Ziel eines dynamischen QR-Codes in der Produktion ändern, ohne den gedruckten Code anzutasten. Der öffentliche Endpoint funktioniert ohne Registrierung. Die vollständige API mit CRUD und Statistiken erfordert einen Pro-Plan.
Welche Endpoints hat die QR-Code API?
Die REST API hat acht Endpoints: öffentliche Generierung ohne Auth, und sieben Pro-Endpoints zum Erstellen, Auflisten, Aktualisieren, Löschen, Herunterladen und Analysieren.
Die API von codigo-qr.es hat zwei Tiers.
Öffentlicher Endpoint (kein Konto erforderlich):
`POST /api/v1/qr/render` generiert einen statischen QR und gibt das Bild in base64 zurück. Limit: 50 Anfragen pro Tag pro IP.
Pro-Endpoints (erfordern API key):
| Methode | Pfad | Zweck | |---------|------|-------| | `GET` | `/api/v1/qr` | Alle QR-Codes auflisten | | `POST` | `/api/v1/qr` | Statischen oder dynamischen QR erstellen | | `GET` | `/api/v1/qr/{id}` | Details eines QR-Codes | | `PATCH` | `/api/v1/qr/{id}` | Ziel oder Name aktualisieren | | `DELETE` | `/api/v1/qr/{id}` | QR-Code löschen | | `GET` | `/api/v1/qr/{id}/image` | PNG- oder SVG-Bild herunterladen | | `GET` | `/api/v1/qr/{id}/stats` | Scan-Statistiken |
Alle Pro-Antworten folgen `{ "data": {...}, "error": null }`.
Wie erhalte ich einen QR-API key?
Der API key wird in /panel/konto mit einem Klick generiert. Er ist nur mit aktivem Pro-Plan verfügbar und kann vom selben Dashboard widerrufen werden.
Schritt 1. Erstellen Sie ein Konto auf codigo-qr.es.
Schritt 2. Aktivieren Sie den Pro-Plan. Die vollständige API ist Pro-exklusiv für 5,99€/Monat.
Schritt 3. Gehen Sie zu /panel/konto und klicken Sie auf «API key generieren». Das Token wird einmal angezeigt. Speichern Sie es.
Fügen Sie diesen Header jeder Anfrage hinzu:
```bash curl https://codigo-qr.es/api/v1/qr \ -H "Authorization: Bearer cqr_ihr_token" ```
Wie generiert man einen QR-Code per API ohne Registrierung?
Der Endpoint /api/v1/qr/render generiert QR PNG oder SVG ohne Konto und ohne API key, mit einem Limit von 50 Anfragen pro Tag pro IP.
```bash curl -X POST https://codigo-qr.es/api/v1/qr/render \ -H "Content-Type: application/json" \ -d '{"value":"https://ihrewebsite.de","format":"png","size":512}' ```
Parameter: `value` (Pflicht), `format` (png oder svg), `size` (256, 512 oder 1024).
Bei mehr als 50 Anfragen pro Tag erhalten Sie `429 RATE_LIMITED` mit dem Header `Retry-After`.
Wie erstellt und aktualisiert man dynamische QR-Codes per API?
POST /api/v1/qr erstellt den dynamischen QR und gibt seine ID zurück. PATCH /api/v1/qr/{id} ändert das Ziel ohne den Code neu zu generieren oder zu drucken.
Einen dynamischen QR erstellen:
```bash curl -X POST https://codigo-qr.es/api/v1/qr \ -H "Authorization: Bearer cqr_ihr_token" \ -H "Content-Type: application/json" \ -d '{ "label": "Speisekarte Mai", "type": "url", "value": "https://ihrgaststaette.de/speisekarte-mai", "is_dynamic": true, "tracking_mode": "redirect" }' ```
Ziel ohne Nachdruck ändern:
```bash curl -X PATCH https://codigo-qr.es/api/v1/qr/{id} \ -H "Authorization: Bearer cqr_ihr_token" \ -H "Content-Type: application/json" \ -d '{"destination": "https://ihrgaststaette.de/speisekarte-juni"}' ```
Wofür wird die QR-API in einem Unternehmen eingesetzt?
Die QR-API ist nützlich, wenn Sie mehr als zehn Codes pro Monat generieren oder aktualisieren müssen: Rechnungen, digitale Speisekarten oder Ticketsysteme.
E-Commerce: Das ERP generiert einen QR pro Lieferschein. Ändert sich die URL, aktualisiert `PATCH` das Ziel ohne Nachdruck.
Restaurants: Die Kasse erstellt einen QR pro Tisch. Der Koch aktualisiert die Karte im CMS; der QR leitet immer zur aktuellen Version.
Veranstaltungen: Das Ticketsystem generiert einen einzigartigen QR pro Ticket. Am Eingang prüft der Scanner via API.
Logistik: Jedes Paket hat einen QR für die Tracking-Seite. Scans sind in `GET /api/v1/qr/{id}/stats` gespeichert.
Wie viele Anfragen erlaubt die QR-API?
Der öffentliche Endpoint akzeptiert 50 Anfragen pro Tag pro IP. Pro-Endpoints erlauben 60 Anfragen pro Minute pro Benutzer.
Öffentliches Tier: 50 pro Tag pro IP, ohne Registrierung.
Pro-Tier: 60 pro Minute pro Benutzer, kein tägliches Gesamtlimit.
Bei Überschreitung gibt die API `429` mit den Headern `X-RateLimit-Limit`, `X-RateLimit-Remaining` und `Retry-After` zurück.
Siehe die vollständige Dokumentation für alle Parameter.
§CODIGO-QR.ES / PRO
Beginnen Sie noch heute mit der QR-API-Integration
Erstellen Sie Ihr Konto, aktivieren Sie den Pro-Plan und generieren Sie Ihren ersten API key in unter 2 Minuten.
Preguntas frecuentes
- Ist die QR-Code API kostenlos?
- Der öffentliche Endpoint ist kostenlos, begrenzt auf 50 Anfragen pro Tag pro IP. Die vollständige API mit API key, CRUD, Bild und Statistiken erfordert den Pro-Plan für 5,99€/Monat.
- Sind QR-Codes, die via API generiert werden, von jedem Lesegerät lesbar?
- Ja. Die Codes folgen dem ISO/IEC 18004-Standard. Sie funktionieren mit der Handykamera und jeder QR-Lese-App.
- Kann ich das Ziel eines dynamischen QR per API ändern, ohne ihn neu zu drucken?
- Ja. PATCH /api/v1/qr/{id} aktualisiert die Ziel-URL jederzeit. Der gedruckte QR-Code bleibt unverändert.
- Ist der API-Token sicher?
- Es wird nur der SHA-256-Hash gespeichert, niemals der Token im Klartext. Er wird einmal bei der Generierung angezeigt. Widerrufbar in /panel/konto.
Jose Flores
Fundador de codigo-qr.es · codigo-qr.es
Jose Flores es fundador de codigo-qr.es, herramienta de generación de QR dinámicos y códigos de barras creada en Barcelona en 2026. Especializado en soluciones digitales para pequeños negocios, desarrolla herramientas que permiten a restaurantes, comercios y profesionales digitalizar su comunicación sin infraestructura técnica propia.
Más artículos