§DEVELOPERS
Wie integriert man QR-Code-Generierung in eine Anwendung?
Die REST-API von codigo-qr.es generiert statische und dynamische QR-Codes, verwaltet sie und gibt PNG- oder SVG-Bilder aus jeder Sprache mit einem einzigen Aufruf zurück.
Erfordert Pro-Plan
Kann ich die API ohne Registrierung verwenden?
Ja. Der öffentliche Endpoint generiert statische QR-Codes ohne Konto und ohne API key, mit einem Limit von 50 Anfragen pro Tag und IP.
Verwenden Sie POST /api/v1/qr/render mit dem QR-Inhalt, Format und Größe. Sie erhalten das Bild in base64. Ohne Registrierung, ohne Kreditkarte.
Beispiel ohne Authentifizierung
curl -X POST https://codigo-qr.es/api/v1/qr/render \
-H "Content-Type: application/json" \
-d '{"value":"https://yourdomain.com","format":"png","size":512}'Wie funktioniert die API-Authentifizierung?
Die Pro-API verwendet API keys im Authorization-Header. Der key wird in /panel/konto generiert und ist exklusiv für den aktiven Pro-Plan.
Fügen Sie den Header Authorization: Bearer mit Ihrem Token jeder Pro-Anfrage hinzu. Der key wird mit einem Klick in /panel/konto generiert und kann jederzeit widerrufen werden.
Beispiel mit API key
curl https://codigo-qr.es/api/v1/qr \
-H "Authorization: Bearer cqr_your_token_here"Der API key erfordert einen aktiven Pro-Plan. Pläne und Preise ansehen
Welche Endpoints hat die QR-Code API?
Acht Endpoints: ein öffentlicher ohne Auth für sofortige Generierung, und sieben Pro zum Erstellen, Auflisten, Aktualisieren, Löschen, Bild herunterladen und Statistiken anzeigen.
| Methode | Pfad | Verwendungszweck | Plan |
|---|---|---|---|
| POST | /api/v1/qr/render | Generiert einen QR und gibt das Bild in base64 zurück. Ohne Auth. | Öffentlich |
| GET | /api/v1/qr | Listet alle Ihre QR-Codes mit Paginierung auf. | Pro |
| POST | /api/v1/qr | Erstellt einen statischen oder dynamischen QR-Code. | Pro |
| GET | /api/v1/qr/{id} | Gibt die vollständigen Details eines QR-Codes zurück. | Pro |
| PATCH | /api/v1/qr/{id} | Aktualisiert Ziel, Name oder Status. | Pro |
| DELETE | /api/v1/qr/{id} | Löscht einen QR-Code (weiches Löschen, reversibel). | Pro |
| GET | /api/v1/qr/{id}/image | Lädt das PNG- oder SVG-Bild des QR-Codes herunter. | Pro |
| GET | /api/v1/qr/{id}/stats | Scan-Statistiken nach Tag und Land. | Pro |
Wofür wird die QR-API in einem Unternehmen eingesetzt?
E-Commerce, Restaurants, Events und Logistik nutzen sie zur automatischen QR-Generierung in Dokumenten und Systemen ohne manuellen Eingriff.
E-Commerce
Das ERP generiert einen QR pro Lieferschein mit dem Tracking-Link. Ändert sich die URL, aktualisiert PATCH das Ziel ohne Nachdruck.
Restaurants
Die Kasse erstellt einen QR pro Tisch bei Schichtbeginn. Der Koch aktualisiert die Karte im CMS; der QR leitet immer zur aktuellen Version weiter.
Veranstaltungen
Das Ticketsystem generiert einen eindeutigen QR pro Ticket. Am Eingang prüft der Scanner den QR über die API und bestätigt dessen Gültigkeit.
Logistik
Jedes Paket hat einen QR, der auf seine Tracking-Seite zeigt. Scans werden in GET /api/v1/qr/{id}/stats gespeichert.
Wie viele Anfragen erlaubt die QR-API?
Der öffentliche Endpoint akzeptiert 50 Anfragen pro Tag und IP. Pro-Endpoints erlauben 60 Anfragen pro Minute und Benutzer mit API key.
Wenn Sie das Limit überschreiten, gibt die API 429 mit den Headern X-RateLimit-Limit, X-RateLimit-Remaining und Retry-After zurück.
Öffentlich
50
req / day / IP
Pro
60
req / min / user
Häufige Fragen zur QR-API
Der öffentliche Endpoint ist kostenlos, begrenzt auf 50 Anfragen pro Tag und IP. Die vollständige API mit API key, CRUD, Bild und Statistiken erfordert den Pro-Plan für 5,99€/Monat.
PNG und SVG. Verwenden Sie den Parameter format=png oder format=svg. Verfügbare Größen sind 256, 512 und 1024 Pixel.
Ja. PATCH /api/v1/qr/{id} aktualisiert die Ziel-URL jederzeit. Der gedruckte QR-Code bleibt gleich; nur das Ziel ändert sich.
Nur der SHA-256-Hash des Tokens wird gespeichert, niemals der Token im Klartext. Er wird einmal bei der Generierung angezeigt. Sie können den key in /panel/konto widerrufen.
Noch nicht. Die API ist Standard-REST und funktioniert mit jedem HTTP-Client: curl, fetch, axios, Python requests, PHP Guzzle und ähnlichen.
Starten Sie noch heute mit der Integration der QR-API
Erstellen Sie Ihr Konto, aktivieren Sie den Pro-Plan und generieren Sie Ihren ersten API key in unter 2 Minuten.