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
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
|
SMS
Parameter | Typ | Valfritt | Beskrivning |
---|---|---|---|
type | Int | false | Use 2 For a SMS QR Code |
text | String | false | Textmeddelandet. |
number | String | false | Telefonnummer. |
Parameter | Typ | Valfritt | Beskrivning |
---|---|---|---|
type | Int | false | Use 3 For a Email QR Code |
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. |
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 | ![]() |
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 | ![]() |
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
|
||||||||||||||||||||
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 | ![]() |
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 | ![]() |
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
2
3
4
5
6
7
8
9
10
11
12
13
|
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 | ![]() |
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
|
||||
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 | ![]() |
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. |