QR-Code-Generator-API

Generieren Sie QR-Code-Bilder, indem Sie .qr.png an einen beliebigen 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.

Add .qr.png to any Linkly link to get the QR code, served as a PNG

Grundlegende Verwendung

Hängen 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, einer 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

Parameter	Beschreibung	Beispiel
size	Bildgröße in Pixeln (100–2048)	`1024`
fgColor	Vordergrundfarbe (Hex, URL-kodiert)	`%23009eff`
bgColor	Hintergrundfarbe (Hex, URL-kodiert)	`%23ffffff`
qrStyle	Modulsil	`squares`, `dots` oder `fluid`
eyeStyle	Augenmusterstil	`square` oder `rounded`
eyeColorInner	Innere Augenfarbe (Hex)	`%23ff0000`
eyeColorOuter	Äußere Augenfarbe (Hex)	`%230000ff`
logoImage	URL des Logobildes	`https://example.com/logo.png`
logoWidth	Logobreite in Pixeln	`60`
logoHeight	Logohöhe in Pixeln	`60`
logoPadding	Abstand um das Logo in Pixeln	`10`
logoStyle	Logoabstandsform	`square` oder `circle`
quietZone	Abstand um den QR-Code in Pixeln (0–200)	`50`

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

Logodimensionen werden automatisch an die angeforderte Bildgröße angepasst.

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

Stile über die Link-API festlegen

Sie können QR-Code-Stile bei der Erstellung oder Aktualisierung eines Links über die Link-Shortening-API speichern. Übergeben Sie ein JSON-Objekt qr_styles 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
  }
}

Nach dem Speichern werden diese Stile 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:

1Standardstile — Schwarzer Vordergrund auf transparentem Hintergrund, quadratische Module, 1024px
2Gespeicherte Stile — Alle Anpassungen, die Sie im QR-Code-Editor vorgenommen oder über die Link-API festgelegt haben, werden mit dem Link gespeichert
3Abfrageparameter-Overrides — Ü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 lesbar bleibt.

Ratenbegrenzungen

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

Antwort

Eine erfolgreiche Anfrage gibt einen 200-Status mit Content-Type: image/png und die PNG-Bilddaten als Antworttext zurück.

Fehlerantworten geben JSON zurück:

{"error": "Rate limit exceeded"}

QR-Code-Generator-API – Häufig gestellte Fragen

Benötige ich einen API-Schlüssel, um ein QR-Code-Bild zu erhalten?

Nein. Hängen Sie einfach .qr.png an Ihre Short-Link-URL an. Dies ist öffentlich und erfordert keine Authentifizierung.

Kann ich das QR-Code-Bild in E-Mails oder Webseiten einbetten?

Ja. Die .qr.png-URL ist für die Einbettung konzipiert. Verwenden Sie sie als <img>-Quelle in HTML-E-Mails, Webseiten, PDFs oder einem beliebigen System, das Bild-URLs unterstützt.

Sind benutzerdefinierte Farben und Logos enthalten?

Ja. QR-Codes werden mit allen gespeicherten Stilen gerendert, einschließlich benutzerdefinierten Farben, Punkt-/Fluid-Mustern, Augenstilen und Logos. Sie können jeden Stil auch mit Abfrageparametern überschreiben.

Welche Größe haben die generierten Bilder?

Die Standardgröße ist 1024x1024 Pixel. Sie können eine benutzerdefinierte Größe von 100 bis 2048 Pixel mit dem Abfrageparameter size angeben, z. B. ABC123.qr.png?size=2048.

Gibt es eine Ratenbegrenzung?

Ja. Der Endpunkt ist auf 5 Anfragen pro Sekunde pro IP-Adresse begrenzt. Wenn Sie diesen Grenzwert überschreiten, erhalten Sie einen 429-Statuscode.

Kann ich QR-Code-Stile über die API festlegen?

Ja. Übergeben Sie ein qr_styles-Objekt bei der Erstellung oder Aktualisierung eines Links über die Link-Shortening-API. Die gespeicherten Stile werden automatisch angewendet, wenn Sie das .qr.png-Bild anfordern. Siehe den Abschnitt „Stile über die Link-API festlegen" oben.

Kann ich QR-Codes im SVG-Format generieren?

Noch nicht. Die API unterstützt derzeit nur das PNG-Format. SVG-Unterstützung kann in Zukunft hinzugefügt werden.