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://genqrcode.com/api/public/generate?apikey=DIN_API_NØKKEL, eller innenfor `GenQRCode-apikey`-headeren. For resten av denne guiden antar vi bruken av headeren, da dette er den sikrere metoden, men begge metodene kan brukes om hverandre. API-nøkkelen bør behandles som en hemmelighet, og du bør ikke dele den med noen.
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. |
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. |