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

Java Library

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

wep Bruk denne hvis Wi-Fi-nettverket fortsatt bruker gammel WEP-kryptering.
nopass Bruk denne hvis Wi-Fi-nettverket ikke har passord.
wpa Standardverdi. Bruk denne for WPA-kryptering. Hvis du er usikker, bruk denne.

SMS

Parameter Type Valgfritt Beskrivelse
type Int false Use 2 For a SMS QR Code
text String false Tekstmeldingen.
number String false Telefonnummeret.

Email

Parameter Type Valgfritt Beskrivelse
type Int false Use 3 For a Email QR Code
email 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.

Whatsapp

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 Text QR Code example

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 WiFi QR Code example

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

tiff TIFF bildefomat.
svg SVG bildefomat.
gif GIF bildefomat.
obj OBJ bildefomat. Full fargestøtte.
png PNG bildefomat.
jpeg JPEG bildefomat. Støtter ikke gjennomsiktighet.
eps EPS bildefomat.
stl STL bildefomat. Ingen fargestøtte.
webp WEBP bildefomat.
3mf 3MF bildefomat.
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 Color QR Code example

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 Color pattern QR Code example

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
/> /> /> /> /> />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 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 Style and logo QR Code example

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

svg SVG bildefomat.
png PNG bildefomat.
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 Text QR Code example

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.