QR Code Generator API

Genereer QR-codeafbeeldingen door .qr.png toe te voegen aan elke Linkly-kortelink. Geen authenticatie of API-sleutel vereist.

De afbeelding wordt geretourneerd als een PNG met alle opgeslagen QR-codestijlen, inclusief aangepaste kleuren, puntpatronen, oogstijlen en logo's.

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

Basisgebruik

Voeg .qr.png toe aan elke Linkly-kortelink:

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

Dit geeft een 1024x1024 PNG-afbeelding van de QR-code terug. Als u de QR-code's kleuren, stijl of logo in Linkly heeft aangepast, worden deze stijlen automatisch toegepast.

Voorbeeld

Plaats een QR-code in een HTML-pagina:

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

Of gebruik het in een e-mailsjabloon, een PDF of elk systeem dat afbeeldings-URL's ondersteunt.

Stijlparameters

Geef queryparameters door om de opgeslagen QR-stijlen van de link te overschrijven of de afbeeldingsgrootte te wijzigen:

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048
ParameterBeschrijvingVoorbeeld
sizeAfbeeldingsgrootte in pixels (100–2048)1024
fgColorVoorgrondkleur (hex, URL-gecodeerd)%23009eff
bgColorAchtergrondkleur (hex, URL-gecodeerd)%23ffffff
qrStyleModulestijlsquares, dots of fluid
eyeStyleOogpatroonsquare of rounded
eyeColorInnerBinnenoog kleur (hex)%23ff0000
eyeColorOuterBuitenoog kleur (hex)%230000ff
logoImageURL van logoafbeeldinghttps://example.com/logo.png
logoWidthLogobreedte in pixels60
logoHeightLogohoogte in pixels60
logoPaddingOpvulling rond logo in pixels10
logoStyleOpvulingsvorm van logosquare of circle
quietZoneOpvulling rond de QR-code in pixels (0–200)50

Opmerking: hex-kleuren moeten URL-gecodeerd zijn — gebruik %23 in plaats van # (bijvoorbeeld %23ff0000 voor #ff0000).

Logodimensies worden automatisch geschaald naar de aangevraagde afbeeldingsgrootte.

De quietZone voegt witruimte-opvulling toe rond de gehele QR-code, gevuld met bgColor. Dit is handig bij het afdrukken van QR-codes op donkere achtergronden — zonder dit zitten de positieëringsogen direct tegen de rand en kunnen deze mogelijk niet betrouwbaar worden gescand. Bijvoorbeeld: quietZone=50&bgColor=%23ffffff voegt een 50-pixel witte rand toe.

U kunt QR-codestijlen opslaan in een link wanneer u deze via de Link Shortening API maakt of bijwerkt. Geef een qr_styles JSON-object door met een van de hierboven vermelde stijlsleutels:

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

Eenmaal opgeslagen, worden deze stijlen automatisch toegepast wanneer u de .qr.png-afbeelding aanvraagt — geen queryparameters nodig.

Hoe stijlen worden toegepast

QR-codestijlen worden in de volgende volgorde opgelost:

  1. 1
    Standaardstijlen — Zwarte voorgrond op transparante achtergrond, vierkante modules, 1024px
  2. 2
    Opgeslagen stijlen — Alle aanpassingen die u in de QR-code-editor hebt gemaakt of ingesteld via de Link API, worden opgeslagen met de link
  3. 3
    Queryparameteroverschrijvingen — Overschrijf afzonderlijke stijlen per aanvraag via URL-parameters

Als een logo aanwezig is, gebruikt Linkly automatisch hoge foutcorrectie (Level H) om ervoor te zorgen dat de QR-code scanbaar blijft.

Snelheidslimieten

Het eindpunt is beperkt tot 5 aanvragen per seconde per IP-adres. Afbeeldingen worden 5 minuten lang in cache opgeslagen, dus herhaalde aanvragen voor dezelfde QR-code worden snel bediend.

Reactie

Een geslaagde aanvraag retourneert een 200-status met Content-Type: image/png en de PNG-afbeeldingsgegevens als antwoordbody.

Foutresponsen retourneren JSON:

{"error": "Rate limit exceeded"}

QR Code Generator API - Veelgestelde vragen

Heb ik een API-sleutel nodig om een QR-codeafbeelding op te halen?

Nee. Voeg eenvoudig .qr.png toe aan uw kortelink-URL. Dit is openbaar en vereist geen authenticatie.

Kan ik de QR-codeafbeelding in e-mails of webpagina's insluiten?

Ja. De .qr.png-URL is ontworpen voor insluiting. Gebruik het als een <img>-bron in HTML-e-mails, webpagina's, PDF's of elk systeem dat afbeeldings-URL's ondersteunt.

Zijn aangepaste kleuren en logo's inbegrepen?

Ja. QR-codes worden weergegeven met alle opgeslagen stijlen, inclusief aangepaste kleuren, punt-/vloeipatronen, oogstijlen en logo's. U kunt ook elke stijl overschrijven met queryparameters.

Welke grootte hebben de gegenereerde afbeeldingen?

De standaardgrootte is 1024x1024 pixels. U kunt een aangepaste grootte van 100 tot 2048 pixels opgeven met behulp van de size-queryparameter, bijvoorbeeld ABC123.qr.png?size=2048.

Geldt er een snelheidslimiet?

Ja. Het eindpunt is beperkt tot 5 aanvragen per seconde per IP-adres. Als u dit overschrijdt, ontvangt u een 429-statuscode.

Kan ik QR-codestijlen via de API instellen?

Ja. Geef een qr_styles-object door wanneer u een link via de Link Shortening API maakt of bijwerkt. De opgeslagen stijlen worden automatisch toegepast wanneer u de .qr.png-afbeelding aanvraagt. Zie de sectie Stijlen instellen via de Link API hierboven.

Kan ik QR-codes in SVG-indeling genereren?

Nog niet. De API ondersteunt momenteel alleen PNG-indeling. SVG-ondersteuning kan in de toekomst worden toegevoegd.

Gerelateerde bronnen

Beschikbaarheid per plan

Beschikbaar vanaf Pro

Plannen vergelijken →

Track 500 maandelijkse klikken gratis.