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
| Parameter | Beschrijving | Voorbeeld |
|---|---|---|
| size | Afbeeldingsgrootte in pixels (100–2048) | 1024 |
| fgColor | Voorgrondkleur (hex, URL-gecodeerd) | %23009eff |
| bgColor | Achtergrondkleur (hex, URL-gecodeerd) | %23ffffff |
| qrStyle | Modulestijl | squares, dots of fluid |
| eyeStyle | Oogpatroonstijl | square of rounded |
| eyeColorInner | Binnenste oogkleur (hex) | %23ff0000 |
| eyeColorOuter | Buitenste oogkleur (hex) | %230000ff |
| logoImage | URL van logo-afbeelding | https://example.com/logo.png |
| logoWidth | Logobreedte in pixels | 60 |
| logoHeight | Logohoogte in pixels | 60 |
| logoPadding | Ruimte rond het logo in pixels | 10 |
| logoStyle | Vorm van de logoruimte | square 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:
- 1Standaardstijlen — Zwarte voorgrond op transparante achtergrond, vierkante modules, 1024px
- 2Opgeslagen stijlen — Alle aanpassingen die je hebt gemaakt in de QR-code-editor of ingesteld via de Link API worden opgeslagen bij de link
- 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
- QR-codes Maken - Hoe je QR-codes maakt en aanpast in Linkly
- Een Logo Toevoegen aan een QR-code - Maak merkgebonden QR-codes met je bedrijfslogo
- SVG QR-codes - Download QR-codes in schaalbaar vectorformaat
- Link Verkorting API - Maak en beheer links programmatisch
- Analytics API - Exporteer klikgegevens en verkeerrapporten