QR-Code-Generator-API

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

Das Bild wird als PNG mit allen gespeicherten QR-Code-Stilen zurückgegeben, einschließlich benutzerdefinierter Farben, Punktmuster, Augenstile und Logos.

Grundlegende Verwendung

Hängen Sie .qr.png an jeden Linkly-Kurzlink an:

https://your-domain.com/ABC123.qr.png

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

Beispiel

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

<img src="https://your-domain.com/ABC123.qr.png" alt="QR-Code" />

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

Stil-Parameter

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

https://your-domain.com/ABC123.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	Modulstil	`squares`, `dots` oder `fluid`
eyeStyle	Augenmuster-Stil	`square` oder `rounded`
eyeColorInner	Innere Augenfarbe (Hex)	`%23ff0000`
eyeColorOuter	Äußere Augenfarbe (Hex)	`%230000ff`
logoImage	URL des Logo-Bildes	`https://example.com/logo.png`
logoWidth	Logo-Breite in Pixeln	`60`
logoHeight	Logo-Höhe in Pixeln	`60`
logoPadding	Abstand um das Logo in Pixeln	`10`
logoStyle	Form des Logo-Abstands	`square` oder `circle`

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

Logo-Abmessungen werden automatisch an die angeforderte Bildgröße angepasst.

Stile über die Link-API festlegen

Sie können QR-Code-Stile bei einem Link speichern, wenn Sie ihn über die Link-Kürzungs-API erstellen oder aktualisieren. Übergeben Sie ein qr_styles JSON-Objekt mit beliebigen der oben aufgeführten Stil-Schlü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"
  }
}

Einmal gespeichert, werden diese Stile automatisch angewendet, wann immer Sie das .qr.png-Bild anfordern — keine Abfrageparameter erforderlich.

Wie Stile angewendet werden

QR-Code-Stile werden in folgender Reihenfolge aufgelöst:

1Standard-Stile — 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-Überschreibungen — Überschreiben Sie einzelne Stile pro Anfrage über URL-Parameter

Wenn ein Logo vorhanden ist, verwendet Linkly automatisch hohe Fehlerkorrektur (Stufe H), um sicherzustellen, dass der QR-Code scannbar bleibt.

Ratenlimits

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

Antwort

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

Fehlerantworten geben JSON zurück:

{"error": "Rate limit exceeded"}

FAQ zur QR-Code-Generator-API

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

Nein. Hängen Sie einfach .qr.png an Ihre Kurzlink-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 jedem System, das Bild-URLs unterstützt.

Sind benutzerdefinierte Farben und Logos enthalten?

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

Welche Größe haben die generierten Bilder?

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

Gibt es ein Ratenlimit?

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

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

Ja. Übergeben Sie ein qr_styles-Objekt beim Erstellen oder Aktualisieren eines Links über die Link-Kürzungs-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 könnte in Zukunft hinzugefügt werden.