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 benutzerdefinierter Farben, Punktmuster, Augenstile und Logos.

Fügen Sie .qr.png an einen beliebigen Linkly-Link an, um den QR-Code als PNG zu erhalten
Fügen Sie .qr.png an einen beliebigen Linkly-Link an, um den QR-Code als PNG zu erhalten

Grundlegende Verwendung

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

Stilparameter

Übergeben Sie Abfrageparameter, um die gespeicherten QR-Stile des Links außer Kraft zu setzen oder die Bildgröße zu ändern:

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048
ParameterBeschreibungBeispiel
sizeBildgröße in Pixeln (100–2048)1024
fgColorVordergrundfarbe (Hex, URL-kodiert)%23009eff
bgColorHintergrundfarbe (Hex, URL-kodiert)%23ffffff
qrStyleModullstilsquares, dots oder fluid
eyeStyleAugenmusterstilsquare oder rounded
eyeColorInnerInnere Augenfarbe (Hex)%23ff0000
eyeColorOuterÄußere Augenfarbe (Hex)%230000ff
logoImageURL des Logo-Bildeshttps://example.com/logo.png
logoWidthLogo-Breite in Pixeln60
logoHeightLogo-Höhe in Pixeln60
logoPaddingAbstand um das Logo in Pixeln10
logoStyleLogo-Abstandsformsquare oder circle
quietZoneAbstand 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).

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

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

Sie können QR-Code-Stile speichern, wenn Sie einen Link über die Link-Shortening-API erstellen oder aktualisieren. Übergeben Sie ein qr_styles JSON-Objekt mit den oben aufgeführten Stilschlüsseln:

{
  "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:

  1. 1
    Standardstile – Schwarzer Vordergrund auf transparentem Hintergrund, quadratische Module, 1024px
  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-Overrides – Überschreiben Sie einzelne Stile pro Anfrage über URL-Parameter

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

Ratenbegrenzungen

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 bereitgestellt werden.

Antwort

Eine erfolgreiche Anfrage gibt einen 200 Status mit Content-Type: image/png und die PNG-Bilddaten als Antwortkörper 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 zum Einbetten 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-/Fluidmuster, Augenstile und Logos. Sie können jeden Stil auch mit Abfrageparametern außer Kraft setzen.

Wie groß sind 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 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 beim Erstellen oder Aktualisieren 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.

Verwandte Ressourcen

Tarifverfügbarkeit

Verfügbar ab Pro

Tarife vergleichen →

Verfolgen Sie 500 monatliche Klicks kostenlos.