Udvikler QR Code API Guide
QR Code API'en giver brugerne mulighed for at generere QR-koder af høj kvalitet programmatisk eller integrere hurtig QR Code generation i stor mængde. Det giver en simpel og effektiv måde at oprette QR-koder til forskellige anvendelsestilfælde, såsom automatiserede betalinger, integration i apps, produktetiketgenerering og meget mere. API'en understøtter forskellige tilpasningsmuligheder, herunder størrelse, farve, form, kant, type osv. Udviklere kan integrere det i deres applikationer ved at sende HTTP-anmodninger og give en API-nøgle til autentificering, eller bruge vores biblioteker.
API-nøgle
API-nøglen til din konto kan oprettes på kontosiden. API-nøglen kan inkluderes i anmodninger enten som en URL-parameter, for eksempel: https://genqrcode.com/api/public/generate?apikey=YOUR_API_KEY, eller i GenQRCode-apikey-headeren. For resten af denne guide antager vi brugen af headeren, da dette er den sikrere mulighed, men begge metoder kan bruges ombytteligt. API-nøglen bør betragtes som en hemmelighed, og du bør ikke dele den med nogen.
Rate limiting
Rate limiting håndhæves for at sikre retfærdig brug af API'en. Den gratis plan inkluderer 180 tokens per time. Normale QR-koder koster 1 token hver, med en maksimal timesgrænse på 180 tokens, hvilket svarer til 1 QR Code hver 20. sekund. Derudover vil de hurtige opkalds-API'erne koste 1/50 af en token, hvilket svarer til 2,5 QR-koder per sekund. Disse hurtige API-endpoints anbefales, når der ikke er behov for tilpasning af QR-koden. Hvis token-grænsen overskrides, vil der blive returneret en statuskode 429, hvilket indikerer, at anmodningen er blevet rate-limited.
Brug af flere konti for at omgå disse grænser er forbudt. Hvis højere grænser er nødvendige, bedes du kontakte os for prissætning.
Biblioteker
Static QR Code API
QR Code-typer
QR Code-typen er grundlaget for hver QR Code. Den bestemmer, hvordan dataene kodificeres, og hvordan QR-koden opfører sig, når den scannes. Valg af den rette type er essentielt, da det påvirker funktionaliteten af din QR Code. Nedenfor finder du alle de tilgængelige typer, du kan vælge imellem.
Text
Parameter | Type | Valgfri | Beskrivelse |
---|---|---|---|
type | Int | false | Use 0 For a Text QR Code |
text | String | false | Teksten inde i QR-koden. |
WiFi
Parameter | Type | Valgfri | Beskrivelse | ||||||
---|---|---|---|---|---|---|---|---|---|
type | Int | false | Use 1 For a WiFi QR Code | ||||||
network | String | false | Wi-Fi netværksnavnet. | ||||||
password | String | true | Wi-Fi adgangskoden. | ||||||
hidden | String | true | Om Wi-Fi netværket er skjult. | ||||||
encryption | String | true |
Den kryptering, der bruges til Wi-Fi netværket.
Mulige værdier
|
SMS
Parameter | Type | Valgfri | Beskrivelse |
---|---|---|---|
type | Int | false | Use 2 For a SMS QR Code |
text | String | false | Tekstbeskeden. |
number | String | false | Telefonnummeret. |
Parameter | Type | Valgfri | Beskrivelse |
---|---|---|---|
type | Int | false | Use 3 For a Email QR Code |
String | true | E-mailadressen i "Til"-feltet. | |
subject | String | true | Emnet for e-mailen. |
message | String | true | Beskeden i e-mailen. |
Phone
Parameter | Type | Valgfri | Beskrivelse |
---|---|---|---|
type | Int | false | Use 4 For a Phone QR Code |
number | String | false | Telefonnummeret. |
Crypto
Parameter | Type | Valgfri | Beskrivelse |
---|---|---|---|
type | Int | false | Use 5 For a Crypto QR Code |
cryptotype | String | false | Den kryptografiske type, der skal sendes. |
address | String | false | Den kryptografiske adresse for modtageren. |
amount | String | true | Mængden af kryptovaluta, der skal sendes. |
vCard
Parameter | Type | Valgfri | Beskrivelse |
---|---|---|---|
type | Int | false | Use 6 For a vCard QR Code |
vc_first_name | String | false | Fornavnet på vCard'et. |
vc_last_name | String | false | Efternavnet på vCard'et. |
vc_company | String | true | Firmaet. |
vc_job | String | true | Jobbet. |
vc_street | String | true | Gaden. |
vc_city | String | true | Byen. |
vc_state | String | true | Staten. |
vc_zip | String | true | Postnummeret. |
vc_country | String | true | Landet. |
vc_phone | String | true | Telefonnummeret. |
vc_mobile | String | true | Mobiltelefonnummeret. |
vc_fax | String | true | Faxnummeret. |
vc_website | String | true | Webstedets URL. |
vc_email | String | true | E-mailadressen. |
Parameter | Type | Valgfri | Beskrivelse |
---|---|---|---|
type | Int | false | Use 7 For a Whatsapp QR Code |
number | String | false | Telefonnummeret. |
text | String | true | WhatsApp-beskeden. |
vEvent
Parameter | Type | Valgfri | Beskrivelse |
---|---|---|---|
type | Int | false | Use 8 For a vEvent QR Code |
ve_summary | String | true | Resuméet af vEventet. |
ve_description | String | true | Beskrivelsen af vEventet. |
ve_location | String | true | Placeringen af vEventet. |
ve_timezone | String | true | Tidszonen for start- og sluttidspunktet for vEventet. Brug f.eks. "Europe/Amsterdam" for Amsterdam tidszonen. |
ve_url | String | true | URL'en for vEventet. |
ve_start | String | true | Slutningen af vEventet. Brug f.eks. "20250101T083000" for 1. januar 2025 kl. 08:30. |
ve_end | String | true | Starten af vEventet. Brug f.eks. "20250101T093000" for 1. januar 2025 kl. 09:30. |
Geo
Parameter | Type | Valgfri | Beskrivelse |
---|---|---|---|
type | Int | false | Use 9 For a Geo QR Code |
ge_latitude | String | false | Breddegraden, der skal kodes. |
ge_longitude | String | false | Længdegraden, der skal kodes. |
Eksempel på tekst QR Code
URL | https://api.genqrcode.com/public/generate |
---|---|
Anmodningsmetode | POST |
Headers | GenQRCode-apikey: API_KEY |
Body | { "type": 0, "text": "https://genqrcode.com" } |
Svar | ![]() |
Eksempel på Wi-Fi QR Code
URL | https://api.genqrcode.com/public/generate |
---|---|
Anmodningsmetode | POST |
Headers | GenQRCode-apikey: API_KEY |
Body | { "type": 1, "network": "GenQRCode", "password": false, "hidden": false, "encryption": "wpa" } |
Svar | ![]() |
Generelle parametre
Her er alle de tilpasselige generelle parametre beskrevet, og hvordan du bruger dem.
Parameter | Type | Standardværdi | Beskrivelse | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
imageformat | String | png |
Billedformatet for QR-koden.
Mulige værdier
|
||||||||||||||||||||
bordersize | Int | 4 | Kantstørrelse omkring QR-koden. | ||||||||||||||||||||
width | Int | 500 | Bredde af QR-koden. Maksimal størrelse af 2000. | ||||||||||||||||||||
height | Int | 500 | Højde af QR-koden. Maksimal størrelse af 2000. |
Farveparametre
Her er alle de tilpasselige farve-parametre beskrevet, og hvordan du bruger dem.
Parameter | Type | Standardværdi | Beskrivelse |
---|---|---|---|
color | String | #000000 | Farven på QR-koden. Formatet skal være enten #RRGGBB eller #RRGGBBAA. RGBA-værdierne er i hex-format, der går fra 00 til FF. |
custom_color_pattern | String | 1 | Mønsteret af farver, der skal bruges. For eksempel, hvis farverne er #ff0000, #00ff00 og #0000ff, og mønsteret er 1,2,3,3,2,1, vil farverne veksle ifølge dette mønster. Et eksempel vil blive givet senere i guiden. |
background_color | String | #FFFFFF | Baggrundsfarven på QR-koden. For at gøre QR-kodens baggrund gennemsigtig, skal alpha-kanalen sættes til 00. For eksempel, #00000000. |
inner_eye_color | String | #000000 | Farven på de indre øjne af QR-koden. |
outer_eye_color | String | #000000 | Farven på de ydre øjne af QR-koden. |
frame_color | String | #000000 | Farven på rammen omkring QR-koden. En ramme skal være aktiveret, før dette træder i kraft. |
Eksempel på farve QR Code
URL | https://api.genqrcode.com/public/generate |
---|---|
Anmodningsmetode | 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" } |
Svar | ![]() |
Eksempel på farvemønster QR Code
URL | https://api.genqrcode.com/public/generate |
---|---|
Anmodningsmetode | 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" } |
Svar | ![]() |
Ramme, form og logo-parametre
Her er alle de tilpasselige ramme-, form- og logo-parametre beskrevet, og hvordan du bruger dem.
Parameter | Type | Standardværdi | Beskrivelse |
---|---|---|---|
style | Int | 0 |
Stil på QR-kodens felter.
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 |
Stil på QR-kodens indre øjne.
0
1
2
3
4
5
6
7
|
outer_eye_style | Int | 0 |
Stil på QR-kodens ydre øjne.
0
1
2
3
4
5
6
|
frame_style | Int | 0 |
Stil på rammen omkring QR-koden.
0
1
2
3
4
5
6
7
8
9
10
11
12
13
|
frame_text | String | SCAN ME | Teksten inden i rammen. En ramme med tekst skal være konfigureret, før dette bliver synligt. |
logo | String |
Logoet, der skal bruges inde i QR-koden.
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 | Om baggrunden bag logoet skal fjernes. |
Eksempel på logo og form QR Code
URL | https://api.genqrcode.com/public/generate |
---|---|
Anmodningsmetode | 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 } |
Svar | ![]() |
Eksempel på brugerdefineret logo
For at bruge et brugerdefineret logo, skal vi uploade vores logo ved hjælp af en multipart-form-data-anmodning. Resultatet kan bruges i logo-feltet.
URL | https://api.genqrcode.com/public/upload/logo |
---|---|
Anmodningsmetode | POST |
Headers | GenQRCode-apikey: API_KEY Content-Type: multipart/form-data |
Svar | 586d0136af8a06e4a2b50cf9f2af0b72 |
Hurtig QR Code API
Den Hurtige QR Code API koster kun 1/50 tokens af den normale API. QR-koderne er optimeret til hastighed og downloadstørrelse. Selvom det understøtter alle QR Code-typer, understøtter det kun nogle få tilpasningsparametre.
Hurtig QR Code-parametre
Her er alle de hurtige QR Code-parametre beskrevet, og hvordan du bruger dem.
Parameter | Type | Standardværdi | Beskrivelse | ||||
---|---|---|---|---|---|---|---|
imageformat | String | png |
Billedformatet for QR-koden.
Mulige værdier
|
||||
bordersize | Int | 4 | Kantstørrelse omkring QR-koden. | ||||
width | Int | 500 | Bredde af QR-koden. Den vil automatisk blive ændret til den nærmeste konfigurerede størrelse for at undgå forvrængning. Maksimal størrelse af 4000. | ||||
height | Int | 500 | Højde af QR-koden. Den vil automatisk blive ændret til den nærmeste konfigurerede størrelse for at undgå forvrængning. Maksimal størrelse af 4000. |
Eksempel på hurtig tekst QR Code
URL | https://api.genqrcode.com/public/fastgenerate |
---|---|
Anmodningsmetode | POST |
Headers | GenQRCode-apikey: API_KEY |
Body | { "imageformat": "png", "type": 0, "text": "https://genqrcode.com" } |
Svar | ![]() |
Hurtig Batch QR Code API
Eksempel på hurtig batch tekst QR Code
URL | https://api.genqrcode.com/public/fastbatch |
---|---|
Anmodningsmetode | 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 } } |
Svar | QR Codes in a zip file. |