Zum Inhalt springen
QRflick

Entwickler-Ratgeber

Erstelle Hunderte QR-Codes aus deinem eigenen System.

Erstelle einen Code für jedes Produkt, jeden Tisch oder jedes Poster aus einer Tabelle oder deiner eigenen Software und ändere sie alle später ohne Neudruck.

Ein Entwickler arbeitet an zwei Monitoren voller Code, auf dem Schreibtisch ein Handy mit QR-Code.
BeispielvorschauQRflick

Kurz gesagt

Die REST-API und Webhooks sind derzeit geschlossen. Schlüssel kannst du unter Einstellungen → Entwickler vorbereiten. Die Verfügbarkeit von MCP wird separat gesteuert. Die REST-API von QRflick erstellt und verwaltet dynamische QR-Codes aus deinem eigenen Code. Erstelle unter Einstellungen → Entwickler einen API-Schlüssel und sende dann für jeden Code POST https://qrflick.com/api/v1/qr-codes mit Typ, Name und Payload. Jeder Code bekommt einen Kurzlink, den du später ändern kannst, Scan-Statistiken und druckfertige PNG-, SVG-, PDF- und EPS-Dateien.

Eine Anfrage pro Code

Sende Typ, Name und Inhalt. Ergänze Design, Ordner und Tags in derselben Anfrage.

Sichere Wiederholungen

Sende mit jeder Erstellungsanfrage einen Idempotency-Key-Header. Wird eine Anfrage nach einem Netzwerkfehler wiederholt, entsteht kein doppelter Code.

Druckdateien

Lade jeden Code als PNG, SVG, PDF oder EPS in der Größe und Auflösung herunter, die deine Druckerei braucht.

Statistiken und Webhooks

Lies Scans pro Tag und ihre Aufschlüsselung oder erhalte einen Webhook, wenn ein Code erstellt oder gescannt wird.

Von der Idee zur Verbindung

Mach es nützlich. Halte es aktuell.

  1. 1 API-Schlüssel erstellenÖffne Einstellungen → Entwickler und erstelle einen Schlüssel mit Schreibzugriff. Kopiere ihn sofort: Er wird nur einmal angezeigt.
  2. 2 Erste Anfrage sendenSende POST an /api/v1/qr-codes mit deinem Schlüssel im Authorization-Header.
  3. 3 Deine Liste durchlaufenErstelle einen Code pro Zeile deiner Tabelle oder Datenbank, mit einem Idempotency-Key pro Zeile.
  4. 4 Herunterladen und druckenRufe die Druckdatei jedes Codes über /api/v1/qr-codes/{id}/image ab.

Im Detail: Erstelle Hunderte QR-Codes aus deinem eigenen System

Wie sieht eine Erstellungsanfrage aus?

Starte mit GET /api/v1/me, um Arbeitsbereich, Schlüsselzugriff und aktuelle Limits zu prüfen. Bewahre den API-Schlüssel auf deinem Server auf, nie in Browser-JavaScript oder einem Mobile-App-Bundle.

POST https://qrflick.com/api/v1/qr-codes mit den Headern Authorization: Bearer api_… und Content-Type: application/json und einem Body wie {"type": "url", "name": "Table 12", "payload": {"url": "https://example.com/menu"}, "folder": "Tables"}.

Die Antwort enthält die ID des Codes, seinen Kurzlink und sein vollständiges Design. Speichere die ID neben deinem eigenen Datensatz, damit du den Code später aktualisieren kannst.

Wie erstelle ich Codes in großen Mengen?

Durchlaufe deine Liste und sende eine Erstellungsanfrage pro Zeile, mit einem eindeutigen Idempotency-Key für jede Zeile (zum Beispiel die eigene ID der Zeile). Bleib innerhalb der Anfragen pro Minute deines Tarifs; bist du schneller, antwortet die API mit 429 und einem Retry-After-Header.

Für einen einmaligen Import ohne Code importiert das Dashboard in Tarifen mit Massenimport auch Codes aus einer CSV-Datei.

Wie ändere ich einen Code nach dem Druck?

Wenn du payload mitsendest, ersetzt es den kompletten gespeicherten Payload. Lies den Code zuerst, behalte alle Pflichtfelder bei und lass die IDs von Umfrageoptionen und Formularfragen stabil. Das design auf oberster Ebene steuert das QR-Bild; payload.design steuert die gehostete Seite.

Sende PATCH /api/v1/qr-codes/{id} nur mit den Feldern, die du ändern willst, zum Beispiel einem neuen payload. Der gedruckte Code funktioniert weiter und öffnet das neue Ziel.

Löschst du einen Code mit DELETE /api/v1/qr-codes/{id}, funktioniert keine gedruckte Kopie mehr. Pausiere oder archiviere Codes deshalb lieber, wenn du unsicher bist.

Wo ist die vollständige Referenz?

GET /api/v1/qr-types listet aktuelle Payload-Felder und Beispiele auf, darunter Umfragen, Formulare, Event-Agenden und Gutscheinbedingungen. GET /api/v1/qr-codes/{id}/poll-results liefert private Summen. GET /api/v1/qr-codes/{id}/form-responses liefert seitenweise Antworten und Zuordnung zu Quelle/UTM; filtere mit since und source. Diese Berichte akzeptieren Schlüssel mit Lesezugriff. Formulareinsendungen und Stimmen lösen derzeit keine Webhooks aus.

Die Entwicklerseite listet jeden Endpunkt auf, und die OpenAPI-Beschreibung unter https://qrflick.com/developers/openapi.json funktioniert mit den meisten API-Tools und Codegeneratoren.

Fragen und Antworten

Welche Tarife enthalten die API?

Tarife mit API-Zugriff (demnächst), im Preisvergleich zu sehen. Dein Tarif legt auch fest, wie viele Anfragen du pro Minute senden kannst.

Kann ich mein Logo über die API hochladen?

Ja. Sende die Datei per POST an /api/v1/uploads/logos und nutze die zurückgegebene ID als design.logo_upload_id.

Kann ich auch statische QR-Codes erstellen?

Ja. POST /api/v1/static-qr-codes liefert ein statisches Code-Bild für jeden der 12 Typen, ohne etwas in deinem Konto zu speichern.

Von QRflick · Geprüft von Haroon, Mitgründer von HS Digital · · So entstehen diese Ratgeber

Deine nächste Verbindung wartet.
Mach deinen nächsten Scan
zum Anfang von etwas.

Dein nächster Kunde sucht vielleicht schon. Mach es leicht, dich zu finden.

Ersten QR-Code kostenlos erstellen Keine Kreditkarte. Kein Ablaufdatum. Nur Möglichkeiten.