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

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, einem PDF oder einem anderen 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 statt # (z. B. %23ff0000 für #ff0000).

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

Der 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 ihn sitzen die Positionierungsaugen bündig am Rand 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.

Stile über die Link-API festlegen

Sie können QR-Code-Stile für einen Link speichern, indem Sie ihn über die Link-Shortening-API erstellen oder aktualisieren. Ü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
  }
}

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 hohe Fehlerkorrektur (Level H), um sicherzustellen, dass der QR-Code scanbar bleibt.

Ratenlimitierung

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 Antworttext zurück.

Fehlerantworten geben JSON zurück:

{"error": "Rate limit exceeded"}

Verwandte Ressourcen

• QR-Codes erstellen – Erstellen und personalisieren Sie QR-Codes in Linkly
• Ein Logo zu einem QR-Code hinzufügen – Erstellen Sie 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 Traffic-Berichte