Utvikler QR Code API Guide
QR Code API gir brukerne muligheten til å programmatisk generere QR-koder av høy kvalitet, eller integrere høyhastighets generering av QR-koder. Det gir en enkel og effektiv måte å lage QR-koder for ulike bruksområder, som automatiserte betalinger, integrasjon i apper, generering av produktetiketter og mye mer. API-en støtter forskjellige tilpasningsmuligheter, inkludert størrelse, farge, form, ramme, type, osv. Utviklere kan integrere det i applikasjonene sine ved å gjøre HTTP-forespørsler og gi en API-nøkkel for autentisering, eller ved å bruke våre biblioteker.
API-nøkkel
API-nøkkelen for kontoen din kan opprettes på kontosiden. API-nøkkelen kan inkluderes i forespørsler enten som en URL-parameter, for eksempel: https://api.genqrcode.com/public/generate?apikey=YOUR_API_KEY, eller i `GenQRCode-apikey`-headeren. For resten av denne veiledningen vil vi anta bruk av headeren, da dette er det sikrere alternativet, men begge metodene kan brukes om hver
Rate limiting
Rate limiting blir håndhevet for å sikre rettferdig bruk av API-en. Gratisnivået inkluderer 180 tokens per time. Vanlige QR-koder koster 1 token hver, med en maksimal timegrense på 180 tokens, som tilsvarer 1 QR-kode hver 20. sekund. I tillegg vil de raske anropene koste 1/50 av et token, som tilsvarer 2,5 QR-koder per sekund. Disse raske endepunktene anbefales når ingen tilpasning av QR-koden er nødvendig. Hvis token-grensen overskrides, returneres en statuskode på 429, som indikerer at forespørselen har blitt rate-limited.
Bruken av flere kontoer for å omgå disse grensene er forbudt. Hvis høyere grenser er nødvendige, vennligst kontakt oss for prising.
Biblioteker
Statisk QR Code API
QR Code-typer
QR Code-typen er grunnlaget for hver QR-kode. Den bestemmer hvordan dataene blir kodet og hvordan QR-koden oppfører seg når den skannes. Å velge riktig type er viktig, da det påvirker funksjonaliteten til QR-koden. Nedenfor finner du alle tilgjengelige typer å velge mellom.
Text
Parameter | Type | Valgfritt | Beskrivelse |
---|---|---|---|
type | Int | false | Use 0 For a Text QR Code |
text | String | false | Teksten inni QR-koden. |
WiFi
Parameter | Type | Valgfritt | Beskrivelse | ||||||
---|---|---|---|---|---|---|---|---|---|
type | Int | false | Use 1 For a WiFi QR Code | ||||||
network | String | false | Wi-Fi-nettverksnavnet. | ||||||
password | String | true | Wi-Fi-passordet. | ||||||
hidden | String | true | Om Wi-Fi-nettverket er skjult. | ||||||
encryption | String | true |
Krypteringen brukt for Wi-Fi-nettverket.
Mulige verdier
|
SMS
Parameter | Type | Valgfritt | Beskrivelse |
---|---|---|---|
type | Int | false | Use 2 For a SMS QR Code |
text | String | false | Tekstmeldingen. |
number | String | false | Telefonnummeret. |
Parameter | Type | Valgfritt | Beskrivelse |
---|---|---|---|
type | Int | false | Use 3 For a Email QR Code |
String | true | E-postadressen i "Til"-feltet. | |
subject | String | true | Emnet for e-posten. |
message | String | true | Meldingen i e-posten. |
Phone
Parameter | Type | Valgfritt | Beskrivelse |
---|---|---|---|
type | Int | false | Use 4 For a Phone QR Code |
number | String | false | Telefonnummeret. |
Crypto
Parameter | Type | Valgfritt | Beskrivelse |
---|---|---|---|
type | Int | false | Use 5 For a Crypto QR Code |
cryptotype | String | false | Kryptotype som skal sendes. |
address | String | false | Kryptoadressen til mottakeren. |
amount | String | true | Beløpet av kryptovaluta som skal sendes. |
vCard
Parameter | Type | Valgfritt | Beskrivelse |
---|---|---|---|
type | Int | false | Use 6 For a vCard QR Code |
vc_first_name | String | false | Fornavnet til vCarden. |
vc_last_name | String | false | Etternavnet til vCarden. |
vc_company | String | true | Selskapet. |
vc_job | String | true | Jobben. |
vc_street | String | true | Gateadressen. |
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 | Faksnummeret. |
vc_website | String | true | Nettstedet. |
vc_email | String | true | E-postadressen. |
vc_note | String | true | Et notat. |
Parameter | Type | Valgfritt | Beskrivelse |
---|---|---|---|
type | Int | false | Use 7 For a Whatsapp QR Code |
number | String | false | Telefonnummeret. |
text | String | true | WhatsApp-meldingen. |
vEvent
Parameter | Type | Valgfritt | Beskrivelse |
---|---|---|---|
type | Int | false | Use 8 For a vEvent QR Code |
ve_summary | String | true | Sammendraget av vEventen. |
ve_description | String | true | Beskrivelsen av vEventen. |
ve_location | String | true | Lokasjonen for vEventen. |
ve_timezone | String | true | Tidssonen for start- og sluttidspunkt for vEventen. For eksempel, bruk "Europe/Oslo" for norsk tidssone. |
ve_url | String | true | URL-en til vEventen. |
ve_start | String | true | Starttidspunktet for vEventen. For eksempel, bruk "20250101T083000" for 1. januar 2025 kl. 08:30. |
ve_end | String | true | Sluttidspunktet for vEventen. For eksempel, bruk "20250101T093000" for 1. januar 2025 kl. 09:30. |
Geo
Parameter | Type | Valgfritt | Beskrivelse |
---|---|---|---|
type | Int | false | Use 9 For a Geo QR Code |
ge_latitude | String | false | Breddegraden som skal kodes. |
ge_longitude | String | false | Lengdegraden som skal kodes. |
Eksempel tekst QR Code
URL | https://api.genqrcode.com/public/generate |
---|---|
Forespørselsmetode | POST |
Headere | GenQRCode-apikey: API_KEY |
Kropp | { "type": 0, "text": "https://genqrcode.com" } |
Respons | ![]() |
Eksempel Wi-Fi QR Code
URL | https://api.genqrcode.com/public/generate |
---|---|
Forespørselsmetode | POST |
Headere | GenQRCode-apikey: API_KEY |
Kropp | { "type": 1, "network": "GenQRCode", "password": false, "hidden": false, "encryption": "wpa" } |
Respons | ![]() |
Generelle parametre
Her er alle de tilpassbare generelle parametrene beskrevet om hvordan de skal brukes.
Parameter | Type | Standardverdi | Beskrivelse | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
imageformat | String | png |
Bildeformatet til QR-koden.
Mulige verdier
|
||||||||||||||||||||
bordersize | Int | 4 | Kantstørrelse rundt QR-koden. | ||||||||||||||||||||
width | Int | 500 | Bredde på QR-koden. Maksimal størrelse på 2000. | ||||||||||||||||||||
height | Int | 500 | Høyde på QR-koden. Maksimal størrelse på 2000. |
Fargeparametre
Her er alle de tilpassbare fargeparametrene beskrevet om hvordan de skal brukes.
Parameter | Type | Standardverdi | Beskrivelse |
---|---|---|---|
color | String | #000000 | Fargen på QR-koden. Formatet skal være enten #RRGGBB eller #RRGGBBAA. RGBA-verdiene er i heksadesimalformat, fra 00 til FF. |
custom_color_pattern | String | 1 | Fargemønsteret som skal brukes. For eksempel, hvis fargene er #ff0000, #00ff00 og #0000ff, og mønsteret er 1,2,3,3,2,1, vil fargene veksle i henhold til dette mønsteret. Et eksempel vil bli gitt senere i veiledningen. |
background_color | String | #FFFFFF | Bakgrunnsfargen til QR-koden. For å gjøre bakgrunnen gjennomsiktig, sett alfakanalen til 00. For eksempel, #00000000. |
inner_eye_color | String | #000000 | Fargen på de indre øynene til QR-koden. |
outer_eye_color | String | #000000 | Fargen på de ytre øynene til QR-koden. |
frame_color | String | #000000 | Fargen på rammen rundt QR-koden. En ramme må være aktivert for at dette skal ha effekt. |
Eksempel farge QR Code
URL | https://api.genqrcode.com/public/generate |
---|---|
Forespørselsmetode | POST |
Headere | GenQRCode-apikey: API_KEY |
Kropp | { "type": 0, "text": "https://genqrcode.com", "color": "#ff0000", "background_color": "#aaffaa", "inner_eye_color": "#ffaaaa", "outer_eye_color": "#ffaaff" } |
Respons | ![]() |
Eksempel fargemønster QR Code
URL | https://api.genqrcode.com/public/generate |
---|---|
Forespørselsmetode | POST |
Headere | GenQRCode-apikey: API_KEY |
Kropp | { "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" } |
Respons | ![]() |
Ramme, Form og Logo-parametere
Her er alle de tilpassbare ramme-, form- og logoparametrene beskrevet om hvordan de skal brukes.
Parameter | Type | Standardverdi | Beskrivelse |
---|---|---|---|
style | Int | 0 |
Stil på QR-kodens firkanter.
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 øyne.
0
1
2
3
4
5
6
7
|
outer_eye_style | Int | 0 |
Stil på QR-kodens ytre øyne.
0
1
2
3
4
5
6
|
frame_style | Int | 0 |
Stil på rammen rundt QR-koden.
0
1
2
3
4
5
6
7
8
9
10
11
12
13
|
frame_text | String | SCAN ME | Teksten inni rammen. En ramme med tekst må være konfigurert før dette blir synlig. |
logo | String |
Logoen som skal brukes inni 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 bakgrunnen bak logoen skal fjernes. |
Eksempel logo og form QR Code
URL | https://api.genqrcode.com/public/generate |
---|---|
Forespørselsmetode | POST |
Headere | GenQRCode-apikey: API_KEY |
Kropp | { "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 } |
Respons | ![]() |
Eksempel tilpasset logo
For å bruke en tilpasset logo, må vi laste opp logoen vår ved å bruke en multipart form data-forespørsel. Resultatet kan brukes i logo-feltet.
URL | https://api.genqrcode.com/public/upload/logo |
---|---|
Forespørselsmetode | POST |
Headere | GenQRCode-apikey: API_KEY Content-Type: multipart/form-data |
Respons | 586d0136af8a06e4a2b50cf9f2af0b72 |
Fast QR Code API
Fast QR Code API koster kun 1/50 tokens av den normale API-en. QR-kodene er optimalisert for hastighet og nedlastingsstørrelse. Selv om det støtter alle QR Code-typene, støtter det kun noen få tilpasningsparametre.
Hurtig QR Code-parametre
Her er alle de raske QR Code-parametrene beskrevet om hvordan de skal brukes.
Parameter | Type | Standardverdi | Beskrivelse | ||||
---|---|---|---|---|---|---|---|
imageformat | String | png |
Bildeformatet til QR-koden.
Mulige verdier
|
||||
bordersize | Int | 4 | Kantstørrelse rundt QR-koden. | ||||
width | Int | 500 | Bredde på QR-koden. Den vil automatisk justere til nærmeste konfigurerte størrelse for å unngå forvrengningsartefakter. Maksimal størrelse på 4000. | ||||
height | Int | 500 | Høyde på QR-koden. Den vil automatisk justere til nærmeste konfigurerte størrelse for å unngå forvrengningsartefakter. Maksimal størrelse på 4000. |
Eksempel rask tekst QR Code
URL | https://api.genqrcode.com/public/fastgenerate |
---|---|
Forespørselsmetode | POST |
Headere | GenQRCode-apikey: API_KEY |
Kropp | { "imageformat": "png", "type": 0, "text": "https://genqrcode.com" } |
Respons | ![]() |
Fast Batch QR Code API
Eksempel rask batch tekst QR Code
URL | https://api.genqrcode.com/public/fastbatch |
---|---|
Forespørselsmetode | POST |
Headere | GenQRCode-apikey: API_KEY |
Kropp | { "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 } } |
Respons | QR Codes in a zip file. |