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
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
|
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. |
Parameter | Type | Optioneel | Beschrijving |
---|---|---|---|
type | Int | false | Use 3 For a Email QR Code |
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. |
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 | ![]() |
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 | ![]() |
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
|
||||||||||||||||||||
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 | ![]() |
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 | ![]() |
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
2
3
4
5
6
7
8
9
10
11
12
13
|
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 | ![]() |
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
|
||||
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 | ![]() |
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. |