QR-code Generator API

Genereer QR-code afbeeldingen door .qr.png toe te voegen aan elke Linkly korte link. Geen authenticatie of API-sleutel vereist.

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

Basisgebruik

Voeg .qr.png toe aan elke Linkly korte link:

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

Dit retourneert een 1024x1024 PNG-afbeelding van de QR-code. Als je de kleuren, stijl of het logo van de QR-code in Linkly hebt aangepast, worden die stijlen automatisch toegepast.

Voorbeeld

Voeg een QR-code in op een HTML-pagina:

<img src="https://your-domain.com/ABC123.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://your-domain.com/ABC123.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
eyeStyleOogpatroonstijlsquare of rounded
eyeColorInnerBinnenste oogkleur (hex)%23ff0000
eyeColorOuterBuitenste oogkleur (hex)%230000ff
logoImageURL van logo-afbeeldinghttps://example.com/logo.png
logoWidthLogobreedte in pixels60
logoHeightLogohoogte in pixels60
logoPaddingRuimte rond het logo in pixels10
logoStyleVorm van de logoruimtesquare of circle

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

Logodimensies worden automatisch geschaald om overeen te komen met de gevraagde afbeeldingsgrootte.

Stijlen Instellen via de Link API

Je kunt QR-codestijlen opslaan bij een link wanneer je deze aanmaakt of bijwerkt via de Link Verkorting API. 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"
  }
}

Eenmaal opgeslagen worden deze stijlen automatisch toegepast wanneer je de .qr.png-afbeelding opvraagt — geen queryparameters nodig.

Hoe Stijlen Worden Toegepast

QR-codestijlen worden in de volgende volgorde opgelost:

  1. 1Standaardstijlen — Zwarte voorgrond op transparante achtergrond, vierkante modules, 1024px
  2. 2Opgeslagen stijlen — Alle aanpassingen die je hebt gemaakt in de QR-code-editor of ingesteld via de Link API worden opgeslagen bij de link
  3. 3Queryparameter-overschrijvingen — Overschrijf individuele stijlen per verzoek via URL-parameters

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

Snelheidslimieten

Het endpoint is beperkt tot 5 verzoeken per seconde per IP-adres. Afbeeldingen worden 5 minuten in de cache bewaard, zodat herhaalde verzoeken voor dezelfde QR-code snel worden bediend.

Antwoord

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

Foutantwoorden retourneren JSON:

{"error": "Rate limit exceeded"}

FAQ van de QR-code Generator API

Heb ik een API-sleutel nodig om een QR-code afbeelding te krijgen?

Nee. Voeg gewoon .qr.png toe aan je korte link-URL. Dit is openbaar en vereist geen authenticatie.

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

Ja. De .qr.png-URL is ontworpen voor insluiting. Gebruik het als <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 gerenderd met alle opgeslagen stijlen, inclusief aangepaste kleuren, punt-/vloeistofpatronen, oogstijlen en logo's. Je kunt ook elke stijl overschrijven met queryparameters.

Hoe groot zijn de gegenereerde afbeeldingen?

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

Is er een snelheidslimiet?

Ja. Het endpoint is beperkt tot 5 verzoeken per seconde per IP-adres. Als je dit overschrijdt, ontvang je een 429-statuscode.

Kan ik QR-codestijlen instellen via de API?

Ja. Geef een qr_styles-object door bij het aanmaken of bijwerken van een link via de Link Verkorting API. De opgeslagen stijlen worden automatisch toegepast wanneer je de .qr.png-afbeelding opvraagt. Zie de sectie Stijlen Instellen via de Link API hierboven.

Kan ik QR-codes genereren in SVG-formaat?

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

Gerelateerde Bronnen

Volg 500 maandelijkse clicks met alle functies inbegrepen.

Geen creditcard nodig