QR-Code-Generator-API

Generieren Sie QR-Code-Bilder, indem Sie .qr.png an jeden Linkly-Short-Link anhängen. Keine Authentifizierung oder API-Schlüssel erforderlich.

Das Bild wird als PNG mit allen gespeicherten QR-Code-Stilen zurückgegeben, einschließlich benutzerdefinierten Farben, Punktmustern, Augenstilen und Logos.

Grundlegende Verwendung

Fügen Sie .qr.png an jeden Linkly-Short-Link an:

https://linkly.link/2W6Z9.qr.png

Dies gibt ein 1024x1024-PNG-Bild des QR-Codes zurück. Wenn Sie den QR-Code in Linkly angepasst haben (Farben, Stil oder Logo), werden diese Stile automatisch angewendet.

Beispiel

Betten Sie einen QR-Code in eine HTML-Seite ein:

<img src="https://linkly.link/2W6Z9.qr.png" alt="QR Code" />

Oder verwenden Sie ihn in einer E-Mail-Vorlage, einem PDF oder einem beliebigen System, das Bild-URLs unterstützt.

Stilparameter

Übergeben Sie Abfrageparameter, um die gespeicherten QR-Stile des Links zu überschreiben oder die Bildgröße zu ändern:

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

Hinweis: Hex-Farben müssen URL-kodiert sein – verwenden Sie %23 anstelle von # (z. B. %23ff0000 für #ff0000).

Logodimensionen werden automatisch skaliert, um der angeforderten Bildgröße zu entsprechen.

Die quietZone fügt um den gesamten QR-Code Leerraum hinzu, ausgefüllt mit bgColor. Dies ist nützlich beim Drucken von QR-Codes auf dunklen Hintergründen – ohne sie sitzen die Positionierungsaugen bündig an der Kante und können möglicherweise nicht zuverlässig gescannt werden. Zum Beispiel quietZone=50&bgColor=%23ffffff fügt einen 50-Pixel-Rand mit weißem Rand hinzu.

Stile über die Link-API festlegen

Sie können QR-Code-Stile beim Erstellen oder Aktualisieren eines Links über die Link Shortening API speichern. Übergeben Sie ein qr_styles JSON-Objekt mit einem der oben aufgeführten Stilschlüssel:

{
  "api_key": "your_api_key",
  "workspace_id": 1234,
  "url": "https://example.com",
  "qr_styles": {
    "fgColor": "#009eff",
    "bgColor": "#ffffff",
    "qrStyle": "dots",
    "eyeStyle": "rounded",
    "logoImage": "https://example.com/logo.png",
    "logoWidth": 60,
    "logoHeight": 60,
    "logoPadding": 10,
    "logoStyle": "circle",
    "quietZone": 50
  }
}

Sobald diese Stile gespeichert sind, werden sie automatisch angewendet, wenn Sie das .qr.png-Bild anfordern – keine Abfrageparameter erforderlich.

Wie Stile angewendet werden

QR-Code-Stile werden in der folgenden Reihenfolge aufgelöst:

1. 1
   Standardstile – Schwarzer Vordergrund auf transparentem Hintergrund, quadratische Module, 1024 px
2. 2
   Gespeicherte Stile – Alle Anpassungen, die Sie im QR-Code-Editor vorgenommen oder über die Link-API festgelegt haben, werden mit dem Link gespeichert
3. 3
   Abfrageparameter-Überschreibungen – Überschreiben Sie einzelne Stile pro Anfrage über URL-Parameter

Wenn ein Logo vorhanden ist, verwendet Linkly automatisch hohe Fehlerkorrektur (Level H), um sicherzustellen, dass der QR-Code weiterhin lesbar ist.

Ratenbeschränkungen

Der Endpunkt ist auf 5 Anfragen pro Sekunde pro IP-Adresse beschränkt. Bilder werden 5 Minuten lang zwischengespeichert, daher werden wiederholte Anfragen für denselben QR-Code schnell bereitgestellt.

Antwort

Eine erfolgreiche Anfrage gibt den Status 200 mit Content-Type: image/png und die PNG-Bilddaten als Antwortkörper zurück.

Fehlerantworten geben JSON zurück:

{"error": "Rate limit exceeded"}

Zugehörige Ressourcen

• QR-Codes erstellen - Erstellen und passen Sie QR-Codes in Linkly an
• Logo zu einem QR-Code hinzufügen - Erstellen Sie gebrändete QR-Codes mit Ihrem Unternehmenslogo
• SVG-QR-Codes - Laden Sie QR-Codes im skalierbaren Vektorformat herunter
• Link Shortening API - Erstellen und verwalten Sie Links programmgesteuert
• Analytics API - Exportieren Sie Klickdaten und Verkehrsberichte