QR-kód-adatok típusonként

curl -X POST "https://getqr.com/api/v1/qrs" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "qrType": "website", "data": "https://example.com/menu", "title": "Menu" }'

​

Minden típus egy pillantásra

​

Hogyan vezet célhoz a QR-kód

• Alapértékek. Létrehozáskor a hiányzó vagy üres link.url a data értékét kapja, és a teljes link objektumot elhagyhatja. Ha mindkettőt elküldi, és eltérnek, a link.url az erősebb. Küldje őket azonos értékkel, vagy csak a data mezőt küldje.
• Mit kódol a kép. A kép a wifi kivételével minden típusnál a rövid linket kódolja. Így módosíthatja, hová vezet egy kinyomtatott kód, és a beolvasásai is követhetők. A WiFi QR-kód magát a hálózatot kódolja: nyomtatás után nem módosítható, és a beolvasásai nem követhetők.
• Sémák. A link.url csak a http:, https:, wifi:, mailto:, sms: és begin: sémát fogadja el. Minden más, köztük a geo:, smsto:, matmsg: és tel:, 422 Invalid destination URL hibát kap, akkor is, ha a data elfogadja.
• Üres data. Üres data esetén a típusellenőrzés kimarad. Átirányító típusnál ilyenkor a link.url mezőt meg kell adni, különben a hívás 400 Missing destination URL hibát kap.
• Felépítés. A típusellenőrzésen túl a szerver nem validálja a tartalmat. Egy JSON-típusnak csak JSON-objektumként kell értelmezhetőnek lennie, a vCardnak pedig csak BEGIN:VCARD sorral kell kezdődnie.

​

Website

{
  "qrType": "website",
  "data": "https://example.com/menu",
  "title": "Menu"
}

• 422 Expected an http(s) URL, e.g. "https://example.com" for qrType "website".
• 422 Invalid destination URL

​

Visszajelzés

{
  "qrType": "feedback",
  "data": "https://forms.gle/abc123"
}

​

Fizetés

https://paypal.me/<user>/25EUR

{
  "qrType": "payment",
  "data": "https://paypal.me/acme/25EUR"
}

​

WhatsApp

https://wa.me/<digits>
https://wa.me/<digits>?text=<urlencoded>

{
  "qrType": "whatsapp",
  "data": "https://wa.me/14155550123?text=Hi%20there"
}

​

Helyszín

https://www.google.com/maps/search/?api=1&query=<address>&query_place_coords=<lat>,<lng>&query_place_id=<id>

{
  "qrType": "location",
  "data": "https://www.google.com/maps/search/?api=1&query=Golden+Gate+Bridge&query_place_coords=37.8199,-122.4783"
}

​

App Link

{
  "qrType": "app",
  "data": "https://apps.apple.com/app/id123456789",
  "link": {
    "ios": "https://apps.apple.com/app/id123456789",
    "android": "https://play.google.com/store/apps/details?id=com.acme.app"
  }
}

• 422 Invalid URL
• 400 Missing destination URL

​

E-mail

mailto:<address>?subject=<subject>&body=<body>

{
  "qrType": "email",
  "data": "mailto:[email protected]?subject=Hello&body=Hi%20there"
}

• 422 Expected a mailto URI, e.g. "mailto:[email protected]?subject=Hello" for qrType "email".

​

SMS

sms:+<digits>
sms:+<digits>?body=<encodeURIComponent(text)>

{
  "qrType": "sms",
  "data": "sms:+14155550123?body=Table%2012"
}

• 422 Expected an SMS URI, e.g. "sms:+14155550123?body=Hello" for qrType "sms".

​

WiFi

WIFI:T:<WPA|WEP|nopass>;S:<ssid>;P:<password>;H:<true|false>;;

{
  "qrType": "wifi",
  "data": "WIFI:T:WPA;S:Cafe Guest;P:espresso42;H:false;;"
}

• 422 Expected a Wi-Fi payload, e.g. "WIFI:T:WPA;S:MyNetwork;P:secret;H:false;" for qrType "wifi".

​

PDF, kép és videó

{
  "qrType": "pdf",
  "data": "",
  "fileId": "file_9f8e7d6c5b4a",
  "title": "Brochure"
}

{
  "qrType": "image",
  "data": "",
  "fileId": "file_3c2b1a0f9e8d",
  "title": "Floor plan"
}

{
  "qrType": "video",
  "data": "",
  "fileId": "file_5e4d3c2b1a0f",
  "title": "Product demo"
}

​

vCard

• N:<last>;<first>;;;: vezeték- és keresztnév. Készítő: mindkettő kötelező, legfeljebb 40 karakter.
• FN:<first> <last>: az oldal nem olvassa. Az irányítópult listájának címkéje ebből származik.
• ORG:<company> és TITLE:<role>: cég és beosztás. Készítő: legfeljebb 40 karakter.
• TEL;TYPE=HOME:, TEL;TYPE=CELL:, TEL;TYPE=WORK:, TEL;TYPE=FAX:: telefon-, mobil-, munkahelyi és faxszám (+ és számjegyek).
• EMAIL:<email>: e-mail-cím.
• URL:<url>: weboldal.
• NOTE:<text>: összefoglaló. Escapelje a \\, \n, \; és \, karaktereket. Készítő: legfeljebb 200 karakter.
• ADR:;;<street>;<city>;<state>;<zip>;<country>: cím.
• X-SOCIALPROFILE;TYPE=<platform>:<url> vagy URL;TYPE=<PLATFORM>:<url>: közösségi linkek, platformonként egy sor.
• PHOTO;VALUE=URI:<url>: a profilkép URL-je. Erősebb bármely fájlazonosítónál.
• X-GETQR-IMAGE-FILEID:<fileId>: profilkép (logo cél).
• X-GETQR-PAGE-LOGO-FILEID:<fileId>: oldallogó (logo cél).
• X-GETQR-LANDING-THEME:p|<0-4> vagy X-GETQR-LANDING-THEME:c|#RRGGBB|#RRGGBB|#RRGGBB: a landing oldal témája, vagy egy előbeállítás indexe (0–4), vagy egyéni háttér-, gomb- és ikonszínek.

{
  "qrType": "vcard",
  "data": "BEGIN:VCARD\r\nVERSION:3.0\r\nN:Doe;Jane;;;\r\nFN:Jane Doe\r\nORG:Acme\r\nTITLE:CTO\r\nTEL;TYPE=CELL:+14155550123\r\nEMAIL:[email protected]\r\nURL:https://acme.com\r\nX-GETQR-LANDING-THEME:p|0\r\nEND:VCARD",
  "title": "Jane Doe"
}

• 422 Expected a vCard payload starting with "BEGIN:VCARD" for qrType "vcard".

​

Social Media

{
  "qrType": "social",
  "data": "{\"firstName\":\"Acme Coffee\",\"summary\":\"Follow us\",\"socialLinks\":[{\"platform\":\"instagram\",\"url\":\"https://instagram.com/acme\"}],\"customItems\":[]}"
}

• 422 Expected a JSON object describing the social profile page for qrType "social".

​

Multi-Link

{
  "qrType": "multilink",
  "data": "{\"title\":\"Acme links\",\"description\":\"Everything in one place\",\"socialLinks\":[],\"customItems\":[{\"name\":\"Shop\",\"url\":\"https://acme.com/shop\",\"logoFileId\":\"\"}]}"
}

• 422 Expected a JSON object describing the multi-link page for qrType "multilink".

​

Event

{
  "qrType": "event",
  "data": "{\"name\":\"Launch party\",\"eventType\":\"productLaunch\",\"start\":\"2026-11-20T18:00\",\"end\":\"2026-11-20T22:00\",\"timezone\":\"Europe/Berlin\",\"city\":\"Berlin\",\"country\":\"Germany\",\"facilities\":[\"freeEntry\"],\"socialLinks\":[],\"ticketsUrl\":\"https://acme.com/tickets\"}"
}

• 422 Expected a JSON object describing the event page for qrType "event".

​

Fájlok a QR-kódokban

• pdf, image, video. Egy PDF, Image vagy Video QR-kód tartalma.
• logo. Profilképek, oldallogók, egyéni linkek ikonjai és középső logók.

​

Típusváltás

1. vcard, social, multilink, event: mindig a hosztolt oldal.
2. Az irányítópulton készült PDF-csomag vagy képgaléria: annak landing oldala.
3. pdf, image, video: a fájl URL-je (az új fileId, különben a tárolt).
4. A link.url, ha elküldi.
5. A módosított data.
6. A tárolt URL.

• pdf, image vagy video típusról. A fileId és az esetleges csomag vagy galéria törlődik.
• pdf, image vagy video típusra. Küldje el a fileId mezőt is, különben a tárolt érték kerül újra felhasználásra, ami akár egy vCard-fotó is lehet.
• app típusról. Az alkalmazás neve, a link.ios és a link.android törlődik, így a telefonok az új célra jutnak.
• wifi típusra. A kép a nyers tartalomra vált. A már kinyomtatott kódok továbbra is a rövid linket tartalmazzák, amely mostantól egy wifi: URL-re irányít át.
• wifi típusról. A kinyomtatott kódok a régi hálózatot tartják meg.
• vcard, social, multilink vagy event típusra. A rövid link az új hosztolt oldalra mutat.
• vcard, social, multilink vagy event típusról. Küldje el az új data értéket. A cél ezt követi.

​

Az API-n keresztül nem támogatott

​

Gyakori problémák

​

Következő lépések