Utvecklare QR-kod API Guide

QR-kod API gör det möjligt för användare att programmässigt generera högkvalitativa QR-koder eller integrera snabb QR-kodsgenerering i stora volymer. Det ger ett enkelt och effektivt sätt att skapa QR-koder för olika användningsområden, såsom automatiserade betalningar, integration i appar, generering av produktetiketter och mycket mer. API:et stödjer olika anpassningsalternativ, inklusive storlek, färg, form, kant, typ, etc. Utvecklare kan integrera det i sina applikationer genom att göra HTTP-förfrågningar och tillhandahålla en API-nyckel för autentisering, eller använda våra bibliotek.

API-nyckel

API-nyckeln för ditt konto kan skapas på kontosidan. API-nyckeln kan inkluderas i förfrågningar antingen som en URL-parameter, till exempel: https://genqrcode.com/api/public/generate?apikey=YOUR_API_KEY, eller inom `GenQRCode-apikey`-huvudet. För resten av denna guide kommer vi att anta användningen av huvudet, eftersom detta är det säkrare alternativet, men båda metoderna kan användas omväxlande. API-nyckeln bör behandlas som en hemlighet och du bör inte dela den med någon.

Begränsning av förfrågningar

Begränsning av förfrågningar tillämpas för att säkerställa rättvis användning av API:et. Den fria nivån inkluderar 180 tokens per timme. Vanliga QR-koder kostar 1 token var, med ett maximalt timbegräns på 180 tokens, vilket motsvarar 1 QR-kod var 20:e sekund. Dessutom kostar de snabba API-slutpunkterna 1/50 av en token, vilket motsvarar 2,5 QR-koder per sekund. Dessa snabba slutpunkter rekommenderas när ingen anpassning av QR-koden krävs. Om token-gränsen överskrids kommer en statuskod på 429 att returneras, vilket indikerar att förfrågningen har blivit begränsad.

Användning av flera konton för att kringgå dessa gränser är förbjudet. Om högre gränser behövs, vänligen kontakta oss för prissättning.

Bibliotek

Java Library

Statisk QR-kod API

QR-kodstyper

QR-kodstypen är grunden för varje QR-kod. Den bestämmer hur data kodas och hur QR-koden beter sig vid skanning. Att välja rätt typ är avgörande, eftersom det påverkar funktionaliteten för din QR-kod. Nedan hittar du alla tillgängliga typer att välja mellan.

Text

Parameter Typ Valfritt Beskrivning
type Int false Use 0 For a Text QR Code
text String false Texten inuti QR-koden.

WiFi

Parameter Typ Valfritt Beskrivning
type Int false Use 1 For a WiFi QR Code
network String false Wi-Fi nätverksnamn.
password String true Wi-Fi-lösenord.
hidden String true Om Wi-Fi-nätverket är dolt.
encryption String true Krypteringen som används för Wi-Fi-nätverket.

Möjliga värden

wep Använd detta om Wi-Fi-nätverket fortfarande använder den gamla WEP-krypteringen.
nopass Använd detta om Wi-Fi-nätverket inte har något lösenord.
wpa Standardvärde. Använd detta för WPA-kryptering. Om du är osäker på vilken du ska använda, använd denna.

SMS

Parameter Typ Valfritt Beskrivning
type Int false Use 2 For a SMS QR Code
text String false Textmeddelandet.
number String false Telefonnummer.

Email

Parameter Typ Valfritt Beskrivning
type Int false Use 3 For a Email QR Code
email String true E-postadressen i "Till"-fältet.
subject String true Ämnet för e-posten.
message String true Meddelandet i e-posten.

Phone

Parameter Typ Valfritt Beskrivning
type Int false Use 4 For a Phone QR Code
number String false Telefonnummer.

Crypto

Parameter Typ Valfritt Beskrivning
type Int false Use 5 For a Crypto QR Code
cryptotype String false Typen av crypto som ska skickas.
address String false Crypto-adressen för mottagaren.
amount String true Beloppet av crypto att skicka.

vCard

Parameter Typ Valfritt Beskrivning
type Int false Use 6 For a vCard QR Code
vc_first_name String false Förnamn på vCard.
vc_last_name String false Efternamn på vCard.
vc_company String true Företaget.
vc_job String true Jobb.
vc_street String true Gatan.
vc_city String true Stad.
vc_state String true Stat.
vc_zip String true Postnummer.
vc_country String true Land.
vc_phone String true Telefonnummer.
vc_mobile String true Mobiltelefonnummer.
vc_fax String true Faksnummer.
vc_website String true Webbadress.
vc_email String true E-postadress.

Whatsapp

Parameter Typ Valfritt Beskrivning
type Int false Use 7 For a Whatsapp QR Code
number String false Telefonnummer.
text String true WhatsApp-textmeddelandet.

vEvent

Parameter Typ Valfritt Beskrivning
type Int false Use 8 For a vEvent QR Code
ve_summary String true Sammanfattningen av vEvent.
ve_description String true Beskrivningen av vEvent.
ve_location String true Platsen för vEvent.
ve_timezone String true Tidszonen för start- och sluttid för vEvent. Till exempel använd "Europe/Amsterdam" för Amsterdam-tidszonen.
ve_url String true URL:en för vEvent.
ve_start String true Sluttid för vEvent. Till exempel använd "20250101T083000" för 1 januari 2025 kl. 08:30.
ve_end String true Starttid för vEvent. Till exempel använd "20250101T093000" för 1 januari 2025 kl. 09:30.

Geo

Parameter Typ Valfritt Beskrivning
type Int false Use 9 For a Geo QR Code
ge_latitude String false Latituden att koda.
ge_longitude String false Longituden att koda.

Exempel på text QR-kod

URL https://api.genqrcode.com/public/generate
Förfrågningsmetod POST
Huvuden GenQRCode-apikey: API_KEY
Kropp
{
  "type": 0,
  "text": "https://genqrcode.com"
}
Svar Text QR Code example

Exempel på Wi-Fi QR-kod

URL https://api.genqrcode.com/public/generate
Förfrågningsmetod POST
Huvuden GenQRCode-apikey: API_KEY
Kropp
{
  "type": 1,
  "network": "GenQRCode",
  "password": false,
  "hidden": false,
  "encryption": "wpa"
}
Svar WiFi QR Code example

Allmänna parametrar

Här är alla anpassningsbara allmänna parametrar beskrivna med instruktioner om hur du använder dem.

Parameter Typ Standardvärde Beskrivning
imageformat String png Bildformatet för QR-koden.

Möjliga värden

tiff TIFF-bildformat.
svg SVG-bildformat.
gif GIF-bildformat.
obj OBJ-bildformat. Fullt färgstöd.
png PNG-bildformat.
jpeg JPEG-bildformat. Stöder inte transparens.
eps EPS-bildformat.
stl STL-bildformat. Inget färgstöd.
webp WEBP-bildformat.
3mf 3MF-bildformat.
bordersize Int 4 Kantstorlek runt QR-koden.
width Int 500 Bredden på QR-koden. Maximal storlek är 2000.
height Int 500 Höjden på QR-koden. Maximal storlek är 2000.

Färgparametrar

Här är alla anpassningsbara färgparametrar beskrivna med instruktioner om hur du använder dem.

Parameter Typ Standardvärde Beskrivning
color String #000000 Färgen på QR-koden. Formatet ska vara antingen #RRGGBB eller #RRGGBBAA. RGBA-värdena är i hexadecimalt format, från 00 till FF.
custom_color_pattern String 1 Mönstret av färger som ska användas. Till exempel, om färgerna är #ff0000, #00ff00 och #0000ff, och mönstret är 1,2,3,3,2,1, kommer färgerna att alternera enligt det mönstret. Ett exempel kommer att ges senare i guiden.
background_color String #FFFFFF Bakgrundsfärgen på QR-koden. För att göra QR-kodens bakgrund transparent, sätt alfa-kanalen till 00. Till exempel #00000000.
inner_eye_color String #000000 Färgen på de inre ögonen på QR-koden.
outer_eye_color String #000000 Färgen på de yttre ögonen på QR-koden.
frame_color String #000000 Färgen på ramen runt QR-koden. En ram måste vara aktiverad för att detta ska få effekt.

Exempel på färg QR-kod

URL https://api.genqrcode.com/public/generate
Förfrågningsmetod POST
Huvuden GenQRCode-apikey: API_KEY
Kropp
{
  "type": 0,
  "text": "https://genqrcode.com",
  "color": "#ff0000",
  "background_color": "#aaffaa",
  "inner_eye_color": "#ffaaaa",
  "outer_eye_color": "#ffaaff"
}
Svar Color QR Code example

Exempel på QR-kod med färgmönster

URL https://api.genqrcode.com/public/generate
Förfrågningsmetod POST
Huvuden 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"
}
Svar Color pattern QR Code example

Ram, form och logotyp-parametrar

Här är alla anpassningsbara ram-, form- och logotyp-parametrar beskrivna med instruktioner om hur du använder dem.

Parameter Typ Standardvärde Beskrivning
style Int 0 Stil på QR-kodens fyrkanter.
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 inre ögon.
0
1
2
3
4
5
6
7
outer_eye_style Int 0 Stil på QR-kodens yttre ögon.
0
1
2
3
4
5
6
frame_style Int 0 Stil på ramen runt 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 Texten i ramen. En ram med text måste konfigureras innan detta blir synligt.
logo String Logotypen som ska användas inuti 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 bakgrunden bakom logotypen ska tas bort.

Exempel på QR-kod med logotyp och form

URL https://api.genqrcode.com/public/generate
Förfrågningsmetod POST
Huvuden 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
}
Svar Style and logo QR Code example

Exempel på anpassad logotyp

För att använda en anpassad logotyp behöver vi ladda upp vår logotyp via en multipart form data-förfrågan. Resultatet kan användas i logotypfältet.

URL https://api.genqrcode.com/public/upload/logo
Förfrågningsmetod POST
Huvuden GenQRCode-apikey: API_KEY
Content-Type: multipart/form-data
Svar 586d0136af8a06e4a2b50cf9f2af0b72

Snabb QR-kod API

Snabb QR-kod API kostar bara 1/50 tokens av det vanliga API:et. QR-koderna är optimerade för hastighet och nedladdningsstorlek. Medan den stödjer alla QR-kodstyper, stödjer den endast några få anpassningsparametrar.

Snabb QR-kod Parametrar

Här är alla snabb QR-kodparametrar beskrivna med instruktioner om hur du använder dem.

Parameter Typ Standardvärde Beskrivning
imageformat String png Bildformatet för QR-koden.

Möjliga värden

svg SVG-bildformat.
png PNG-bildformat.
bordersize Int 4 Kantstorlek runt QR-koden.
width Int 500 Bredden på QR-koden. Den justeras automatiskt till närmaste konfigurerade storlek för att undvika artefakter vid ändring. Maximal storlek är 4000.
height Int 500 Höjden på QR-koden. Den justeras automatiskt till närmaste konfigurerade storlek för att undvika artefakter vid ändring. Maximal storlek är 4000.

Exempel på snabb text QR-kod

URL https://api.genqrcode.com/public/fastgenerate
Förfrågningsmetod POST
Huvuden GenQRCode-apikey: API_KEY
Kropp
{
  "imageformat": "png",
  "type": 0,
  "text": "https://genqrcode.com"
}
Svar Text QR Code example

Snabb batch QR-kod API

Exempel på snabb batch text QR-kod

URL https://api.genqrcode.com/public/fastbatch
Förfrågningsmetod POST
Huvuden 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
  }
}
Svar QR Codes in a zip file.