Ontwikkelaar QR Code API Gids

De QR Code API stelt gebruikers in staat om programmatisch hoogwaardige QR-codes te genereren of grote hoeveelheden QR-codes snel te maken. Het biedt een eenvoudige en efficiënte manier om QR-codes te creëren voor diverse toepassingen, zoals geautomatiseerde betalingen, integratie in apps, productlabelgeneratie en meer. De API ondersteunt verschillende aanpassingsopties, waaronder grootte, kleur, vorm, rand, type, etc. Ontwikkelaars kunnen de API integreren in hun applicaties door HTTP-verzoeken te maken en een API-sleutel te gebruiken voor authenticatie, of door onze bibliotheken te gebruiken.

API-sleutel

De API-sleutel voor je account kan worden aangemaakt op de accountpagina. De API-sleutel kan worden opgenomen in verzoeken als URL-parameter, bijvoorbeeld: https://genqrcode.com/api/public/generate?apikey=YOUR_API_KEY, of in de `GenQRCode-apikey`-header. In de rest van deze gids gaan we ervan uit dat de header wordt gebruikt, omdat dit de veiligere optie is, maar beide methoden kunnen door elkaar worden gebruikt. De API-sleutel moet als geheim worden beschouwd en mag niet met anderen worden gedeeld.

Snelheidsbeperking

Snelheidsbeperking wordt toegepast om eerlijk gebruik van de API te garanderen. De gratis versie bevat 180 tokens per uur. Normale QR-codes kosten elk 1 token, met een maximaal uurlijkse limiet van 180 tokens, wat neerkomt op 1 QR-code elke 20 seconden. Daarnaast kosten snelle aanroep-eindpunten slechts 1/50ste van een token, wat neerkomt op 2,5 QR-codes per seconde. Deze snelle eindpunten worden aanbevolen als geen aanpassing van de QR-code nodig is. Als de tokenlimiet wordt overschreden, wordt statuscode 429 geretourneerd, wat aangeeft dat het verzoek is beperkt.

Het gebruik van meerdere accounts om deze limieten te omzeilen is verboden. Als hogere limieten nodig zijn, neem dan contact met ons op voor de prijzen.

Bibliotheken

Java Library

Statische QR Code API

QR Code typen

Het QR Code-type vormt de basis van elke QR-code. Het bepaalt hoe de gegevens worden gecodeerd en hoe de QR-code zich gedraagt bij het scannen. Het kiezen van het juiste type is essentieel, omdat dit de functionaliteit van je QR-code beïnvloedt. Hieronder vind je alle beschikbare typen.

Text

Parameter Type Optioneel Beschrijving
type Int false Use 0 For a Text QR Code
text String false De tekst in de QR Code.

WiFi

Parameter Type Optioneel Beschrijving
type Int false Use 1 For a WiFi QR Code
network String false De Wi-Fi-netwerknaam.
password String true Het Wi-Fi-wachtwoord.
hidden String true Of het Wi-Fi-netwerk verborgen is.
encryption String true De encryptie die voor het Wi-Fi-netwerk wordt gebruikt.

Mogelijke waarden

wep Gebruik dit als het Wi-Fi-netwerk nog steeds de oude WEP-encryptie gebruikt.
nopass Gebruik dit als het Wi-Fi-netwerk geen wachtwoord heeft.
wpa Standaardwaarde. Gebruik dit voor de WPA-encryptie. Als je niet zeker weet welke je moet gebruiken, kies dan deze.

SMS

Parameter Type Optioneel Beschrijving
type Int false Use 2 For a SMS QR Code
text String false Het sms-bericht.
number String false Het telefoonnummer.

Email

Parameter Type Optioneel Beschrijving
type Int false Use 3 For a Email QR Code
email String true Het e-mailadres in het "Aan"-veld.
subject String true Het onderwerp van de e-mail.
message String true Het bericht van de e-mail.

Phone

Parameter Type Optioneel Beschrijving
type Int false Use 4 For a Phone QR Code
number String false Het telefoonnummer.

Crypto

Parameter Type Optioneel Beschrijving
type Int false Use 5 For a Crypto QR Code
cryptotype String false Het Crypto-type dat verzonden moet worden.
address String false Het cryptoadres van de ontvanger.
amount String true De hoeveelheid crypto die verzonden moet worden.

vCard

Parameter Type Optioneel Beschrijving
type Int false Use 6 For a vCard QR Code
vc_first_name String false De voornaam van de vCard.
vc_last_name String false De achternaam van de vCard.
vc_company String true Het bedrijf.
vc_job String true De functie.
vc_street String true De straat.
vc_city String true De stad.
vc_state String true De staat/provincie.
vc_zip String true De postcode.
vc_country String true Het land.
vc_phone String true Het telefoonnummer.
vc_mobile String true Het mobiele telefoonnummer.
vc_fax String true Het faxnummer.
vc_website String true De website-URL.
vc_email String true Het e-mailadres.

Whatsapp

Parameter Type Optioneel Beschrijving
type Int false Use 7 For a Whatsapp QR Code
number String false Het telefoonnummer.
text String true Het WhatsApp-bericht.

vEvent

Parameter Type Optioneel Beschrijving
type Int false Use 8 For a vEvent QR Code
ve_summary String true De samenvatting van de vEvent.
ve_description String true De beschrijving van de vEvent.
ve_location String true De locatie van de vEvent.
ve_timezone String true De tijdzone van de begin- en eindtijd van de vEvent. Gebruik bijvoorbeeld "Europe/Amsterdam" voor de tijdzone van Amsterdam.
ve_url String true De URL van de vEvent.
ve_start String true De begintijd van de vEvent. Gebruik bijvoorbeeld "20250101T083000" voor 1 januari 2025 om 8:30.
ve_end String true De eindtijd van de vEvent. Gebruik bijvoorbeeld "20250101T093000" voor 1 januari 2025 om 9:30.

Geo

Parameter Type Optioneel Beschrijving
type Int false Use 9 For a Geo QR Code
ge_latitude String false De breedtegraad om te coderen.
ge_longitude String false De te coderen lengtegraad.

Voorbeeld tekst QR Code

URL https://api.genqrcode.com/public/generate
Verzoekmethode POST
Headers GenQRCode-apikey: API_KEY
Body
{
  "type": 0,
  "text": "https://genqrcode.com"
}
Antwoord Text QR Code example

Voorbeeld Wi-Fi QR Code

URL https://api.genqrcode.com/public/generate
Verzoekmethode POST
Headers GenQRCode-apikey: API_KEY
Body
{
  "type": 1,
  "network": "GenQRCode",
  "password": false,
  "hidden": false,
  "encryption": "wpa"
}
Antwoord WiFi QR Code example

Algemene parameters

Hier worden alle algemene aanpasbare parameters beschreven en hoe ze te gebruiken.

Parameter Type Standaardwaarde Beschrijving
imageformat String png Het afbeeldingsformaat van de QR Code.

Mogelijke waarden

tiff TIFF afbeeldingsformaat.
svg SVG afbeeldingsformaat.
gif GIF afbeeldingsformaat.
obj OBJ afbeeldingsformaat. Volledige kleurondersteuning.
png PNG afbeeldingsformaat.
jpeg JPEG afbeeldingsformaat. Ondersteunt geen transparantie.
eps EPS afbeeldingsformaat.
stl STL afbeeldingsformaat. Geen kleurondersteuning.
webp WEBP afbeeldingsformaat.
3mf 3MF afbeeldingsformaat.
bordersize Int 4 Randgrootte rond de QR Code.
width Int 500 Breedte van de QR Code. Maximale grootte van 2000.
height Int 500 Hoogte van de QR Code. Maximale grootte van 2000.

Kleurparameters

Hier worden alle aanpasbare kleurparameters beschreven en hoe ze te gebruiken.

Parameter Type Standaardwaarde Beschrijving
color String #000000 De kleur van de QR-code. Het formaat moet #RRGGBB of #RRGGBBAA zijn. De RGBA-waarden zijn hexadecimaal en variëren van 00 tot FF.
custom_color_pattern String 1 Het patroon van kleuren om te gebruiken. Bijvoorbeeld, als de kleuren #ff0000, #00ff00 en #0000ff zijn en het patroon is 1,2,3,3,2,1, wisselen de kleuren zich af volgens dat patroon. Een voorbeeld wordt later in de gids gegeven.
background_color String #FFFFFF De achtergrondkleur van de QR-code. Om de achtergrond transparant te maken, stel de alfawaarde in op 00. Bijvoorbeeld: #00000000.
inner_eye_color String #000000 De kleur van de binnenste ogen van de QR Code.
outer_eye_color String #000000 De kleur van de buitenste ogen van de QR Code.
frame_color String #000000 De kleur van het frame rond de QR Code. Een frame moet worden ingeschakeld voordat dit effect zichtbaar wordt.

Voorbeeld kleur QR Code

URL https://api.genqrcode.com/public/generate
Verzoekmethode POST
Headers GenQRCode-apikey: API_KEY
Body
{
  "type": 0,
  "text": "https://genqrcode.com",
  "color": "#ff0000",
  "background_color": "#aaffaa",
  "inner_eye_color": "#ffaaaa",
  "outer_eye_color": "#ffaaff"
}
Antwoord Color QR Code example

Voorbeeld kleurpatroon QR Code

URL https://api.genqrcode.com/public/generate
Verzoekmethode POST
Headers GenQRCode-apikey: API_KEY
Body
{
  "type": 0,
  "text": "https://genqrcode.com",
  "color": "#e81416,#faeb36,#79c314,#487de7,#4b369d,#70369d",
  "custom_color_pattern": "1,1,2,2,3,3,4,4,5,5,6,6"
}
Antwoord Color pattern QR Code example

Frame-, vorm- en logoparameters

Hier worden alle aanpasbare frame-, vorm- en logoparameters beschreven en hoe ze te gebruiken.

Parameter Type Standaardwaarde Beschrijving
style Int 0 Stijl van de QR-codevierkanten.
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
inner_eye_style Int 0 Stijl van de QR-code binnenste ogen.
0
1
2
3
4
5
6
7
outer_eye_style Int 0 Stijl van de QR-code buitenste ogen.
0
1
2
3
4
5
6
frame_style Int 0 Stijl van het kader rond de QR-code.
0
1
/> /> /> /> /> />SCAN ME
2
/> /> /> /> /> /> /> />SCAN ME
3
/> /> /> />SCAN ME
4
/> /> />SCAN ME
5
/>SCAN ME
6
/>SCAN ME
7
/> /> />
8
/> /> /> /> />
9
/> /> /> /> /> /> /> /> /> /> /> /> />
10
/> /> /> /> /> /> />SCAN ME
11
/> />SCAN ME
12
SCAN ME
13
SCAN ME
frame_text String SCAN ME De tekst binnen het frame. Een frame met tekst moet worden geconfigureerd voordat dit zichtbaar wordt.
logo String Het logo dat in de QR-code moet worden gebruikt.
youtube
wifi
google-maps
facebook
spotify
threads
zoom
instagram
linkedin
genqrcode
google-drive
airbnb
skype
snapchat
twitter
x-twitter
reddit
logo_remove_background Boolean false Of de achtergrond achter het logo verwijderd moet worden.

Voorbeeld logo en vorm QR Code

URL https://api.genqrcode.com/public/generate
Verzoekmethode POST
Headers GenQRCode-apikey: API_KEY
Body
{
  "type": 0,
  "text": "https://x.com/genqrcode",
  "style": 22,
  "inner_eye_style": 1,
  "outer_eye_style": 4,
  "frame": 10,
  "frame_text": "My X Page",
  "logo": "x-twitter",
  "logo_remove_background":true
}
Antwoord Style and logo QR Code example

Voorbeeld aangepast logo

Om een aangepast logo te gebruiken, moeten we ons logo uploaden met een multipart form data-verzoek. Het resultaat kan vervolgens in het logoveld worden gebruikt.

URL https://api.genqrcode.com/public/upload/logo
Verzoekmethode POST
Headers GenQRCode-apikey: API_KEY
Content-Type: multipart/form-data
Antwoord 586d0136af8a06e4a2b50cf9f2af0b72

Snelle QR Code API

De Snelle QR Code API kost slechts 1/50 tokens van de normale API. De QR-codes zijn geoptimaliseerd voor snelheid en downloadgrootte. Hoewel alle QR-code typen worden ondersteund, worden slechts enkele aanpassingsparameters ondersteund.

Snelle QR Code parameters

Hier worden alle snelle QR Code parameters beschreven en hoe ze te gebruiken.

Parameter Type Standaardwaarde Beschrijving
imageformat String png Het afbeeldingsformaat van de QR Code.

Mogelijke waarden

svg SVG afbeeldingsformaat.
png PNG afbeeldingsformaat.
bordersize Int 4 Randgrootte rond de QR Code.
width Int 500 Breedte van de QR Code. Het wordt automatisch aangepast naar de dichtstbijzijnde geconfigureerde grootte om eventuele schaalfouten te voorkomen. Maximale grootte van 4000.
height Int 500 Hoogte van de QR Code. Het wordt automatisch aangepast naar de dichtstbijzijnde geconfigureerde grootte om eventuele schaalfouten te voorkomen. Maximale grootte van 4000.

Voorbeeld snelle tekst QR Code

URL https://api.genqrcode.com/public/fastgenerate
Verzoekmethode POST
Headers GenQRCode-apikey: API_KEY
Body
{
  "imageformat": "png",
  "type": 0,
  "text": "https://genqrcode.com"
}
Antwoord Text QR Code example

Snelle Batch QR Code API

Voorbeeld snelle batch tekst QR Code

URL https://api.genqrcode.com/public/fastbatch
Verzoekmethode POST
Headers GenQRCode-apikey: API_KEY
Body
{
  "QR Code 1": {
    "text": "https://genqrcode.com",
    "type": 0,
    "width": 500,
    "bordersize": 4,
    "imageformat": "png",
    "height": 500
  },
  "QR Code 2": {
    "text": "https://genqrcode.com/dynamicview",
    "type": 0,
    "width": 500,
    "bordersize": 4,
    "imageformat": "png",
    "height": 500
  },
  "QR Code 3": {
    "text": "https://genqrcode.com/pricing",
    "type": 0,
    "width": 500,
    "bordersize": 4,
    "imageformat": "png",
    "height": 500
  }
}
Antwoord QR Codes in a zip file.