> ## Documentation Index > Fetch the complete documentation index at: https://docs.getqr.com/llms.txt > Use this file to discover all available pages before exploring further. # QR-kód-adatok típusonként > Mind a 16 QR-kód-típus adatformátuma, egy kéréspélda és az, hogy mi szerkeszthető nyomtatás után. > [!NOTE] > > A GetQR API béta állapotban van, és csak kiválasztott munkaterületek számára érhető el. A részletek az általános kiadásig változhatnak. Minden QR-kódnak van egy `qrType` értéke, és a típus határozza meg, mit kell tartalmaznia a `data` mezőnek. Ez az útmutató minden típushoz megadja a formátumot, egy működő kéréstörzset, és azt, hogy mit módosíthat még a kód kinyomtatása után. A példák a [QR-kód létrehozása](https://docs.getqr.com/hu/api/endpoints/qr-codes.md#qr-kód-létrehozása) végpont kéréstörzsei. Így küldje el őket: ```bash theme={null} 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 | `qrType` | `data` | Nyomtatás után szerkeszthető | | - | - | - | | [`website`](#website) | http(s) URL | Igen | | [`feedback`](#visszajelzés) | Az űrlap http(s) URL-je | Igen | | [`payment`](#fizetés) | A fizetési szolgáltató URL-je | Igen | | [`whatsapp`](#whatsapp) | `wa.me` link | Igen | | [`location`](#helyszín) | Térkép-URL | Igen | | [`app`](#app-link) | Áruház-URL vagy üres, valamint `link.ios` / `link.android` | Igen | | [`email`](#e-mail) | `mailto:` URI | Igen | | [`sms`](#sms) | `sms:` URI | Igen | | [`wifi`](#wifi) | `WIFI:` tartalom | **Nem** | | [`pdf`, `image`, `video`](#pdf-kép-és-videó) | Üres, `fileId` értékkel | Igen | | [`vcard`](#vcard) | vCard 3.0 szöveg | Igen | | [`social`](#social-media) | JSON-karakterlánc | Igen | | [`multilink`](#multi-link) | JSON-karakterlánc | Igen | | [`event`](#event) | JSON-karakterlánc | Igen | ## Hogyan vezet célhoz a QR-kód Minden QR-kód egy rövid linkből és egy tartalomból áll. A tartalmat két mező hordozza: | Mező | Mi ez | | - | - | | `link.url` | Ahová a rövid link a látogatót küldi. A `wifi` kivételével minden típusnál ez a tényleges cél. | | `data` | A típus tartalma, amelyet a rendszer a `qrType` alapján ellenőriz. Elküldött formájában csak a `wifi`, `vcard`, `social`, `multilink`, `event` és `sms` típusnál tárolódik. Minden más típusnál csak a `link.url` értékét adja, a tárolt `data` pedig a rövid link lesz. A célt a válasz `url` mezőjéből olvassa ki. | Szabályok minden típusra: * **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. > [!TIP] > > Az alább **Készítő** jelöléssel ellátott korlátokat az irányítópult szerkesztője érvényesíti. Az API az ezeket figyelmen kívül hagyó tartalmat is elfogadja, de az furcsán jelenhet meg a landing oldalon vagy a szerkesztőben. ## Website `qrType`: `"website"`. Irányítópult-útmutató: [Website QR-kód](https://docs.getqr.com/hu/qr-types/website.md). | Mező | Működés | | - | - | | `data` | Egy http(s) URL. | | `link.url` | A cél. Alapértelmezés: a `data` értéke. | | `fileId` | Nem engedélyezett. | | Kódolja | A rövid linket, amely a `link.url` címre irányít át. A beolvasások követhetők. | | Nyomtatás után | Szerkeszthető. A cél módosításához küldje el a `data` vagy a `link.url` mezőt. A `data` önmagában is elég. | ```json Request body theme={null} { "qrType": "website", "data": "https://example.com/menu", "title": "Menu" } ``` Hibák: * `422 Expected an http(s) URL, e.g. "https://example.com" for qrType "website".` * `422 Invalid destination URL` ## Visszajelzés `qrType`: `"feedback"`. Irányítópult-útmutató: [Visszajelzés QR-kód](https://docs.getqr.com/hu/qr-types/feedback.md). A `data` a visszajelzési űrlap http(s) URL-je, például egy Google Form vagy egy értékelési oldal. Minden más úgy működik, mint a [Website](#website) típusnál. ```json Request body theme={null} { "qrType": "feedback", "data": "https://forms.gle/abc123" } ``` ## Fizetés `qrType`: `"payment"`. Irányítópult-útmutató: [Fizetési QR-kód](https://docs.getqr.com/hu/qr-types/payment.md). A `data` a szolgáltató fizetési URL-je, például: ```text theme={null} https://paypal.me//25EUR ``` Az irányítópult szerkesztője ezeket a hosztokat ismeri fel: `paypal.me`, `paypal.com/paypalme`, `cash.app`, `venmo.com`, `buy.stripe.com`, `stripe.com`, `square.link` és `payoneer.com`. PayPal esetén az összeg az útvonal utolsó szakasza. Bármely más http(s) URL is működik, de a szerkesztő nem bontja szolgáltatóra és összegre. Minden más úgy működik, mint a [Website](#website) típusnál. ```json Request body theme={null} { "qrType": "payment", "data": "https://paypal.me/acme/25EUR" } ``` ## WhatsApp `qrType`: `"whatsapp"`. Irányítópult-útmutató: [WhatsApp QR-kód](https://docs.getqr.com/hu/qr-types/whatsapp.md). A `data` egy `wa.me` link: a nemzetközi telefonszám számjegyei `+` nélkül, opcionálisan előre kitöltött szöveggel. ```text theme={null} https://wa.me/ https://wa.me/?text= ``` A szerver csak azt ellenőrzi, hogy http(s) URL-ről van-e szó. Az irányítópult az `api.whatsapp.com/send` linkeket is beolvassa. Minden más úgy működik, mint a [Website](#website) típusnál. ```json Request body theme={null} { "qrType": "whatsapp", "data": "https://wa.me/14155550123?text=Hi%20there" } ``` ## Helyszín `qrType`: `"location"`. Irányítópult-útmutató: [Helyszín QR-kód](https://docs.getqr.com/hu/qr-types/location.md). A `data` egy térkép-URL. Használja ezt a formátumot, hogy a QR-kód az irányítópulton szerkeszthető maradjon (a `query_place_id` opcionális): ```text theme={null} https://www.google.com/maps/search/?api=1&query=
&query_place_coords=,&query_place_id= ``` Bármely más http(s) URL is átirányít. Egy `geo:` URI átmegy a `data` ellenőrzésén, de célként a rendszer elutasítja, ezért ne használja. Minden más úgy működik, mint a [Website](#website) típusnál. ```json Request body theme={null} { "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"`. Irányítópult-útmutató: [App Link QR-kód](https://docs.getqr.com/hu/qr-types/app-link.md). | Mező | Működés | | - | - | | `link.ios`, `link.android` | App Store- és Google Play-URL-ek. Az iOS-es látogatók az `ios`, az androidosok az `android` címre jutnak. Beolvasáskor ezek minden mást felülírnak. | | `link.url` | Tartalék cél más eszközökhöz. Alapértelmezés: a `data` értéke, utána az `ios` vagy az `android`. | | `data` | Egy http(s) URL (az irányítópult az áruház URL-jét küldi), vagy üres. A `link.ios`, `link.android`, `link.url` és `data` közül legalább egyet meg kell adni, különben a hívás `400 Missing destination URL` hibát kap. | | `fileId` | Nem engedélyezett. | | Kódolja | A rövid linket. A beolvasások követhetők. | | Nyomtatás után | Szerkeszthető. A `link.ios` és a `link.android` egymástól függetlenül érvényesül, mindegyik csak akkor, ha elküldi. A `null` törli az adott linket. A `qrType` mezőt nem kell újra elküldenie. Más típusra váltáskor mindkét áruházlink törlődik. | ```json Request body theme={null} { "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" } } ``` Hibák: * `422 Invalid URL` * `400 Missing destination URL` ## E-mail `qrType`: `"email"`. Irányítópult-útmutató: [E-mail QR-kód](https://docs.getqr.com/hu/qr-types/email.md). ```text theme={null} mailto:
?subject=&body= ``` | Mező | Működés | | - | - | | `data` | Egy `mailto:` URI, opcionális tárggyal és szöveggel. A szóközöket `%20` formában kódolja: az irányítópult `+` jelként írja őket, amelyet nem minden levelezőalkalmazás olvas szóközként. A `matmsg:` célként elutasításra kerül. | | `link.url` | A `mailto:` URI. Alapértelmezés: a `data` értéke. | | `fileId` | Nem engedélyezett. | | Kódolja | A rövid linket, amely egy oldalt nyit meg, az pedig átadja az üzenetet a levelezőalkalmazásnak. | | Nyomtatás után | Szerkeszthető. Az üzenet módosításához küldje el a `data` vagy a `link.url` mezőt. A `data` önmagában is elég. | ```json Request body theme={null} { "qrType": "email", "data": "mailto:hi@example.com?subject=Hello&body=Hi%20there" } ``` Hibák: * `422 Expected a mailto URI, e.g. "mailto:hi@example.com?subject=Hello" for qrType "email".` ## SMS `qrType`: `"sms"`. Irányítópult-útmutató: [SMS QR-kód](https://docs.getqr.com/hu/qr-types/sms.md). ```text theme={null} sms:+ sms:+?body= ``` | Mező | Működés | | - | - | | `data` | Egy `sms:` URI, opcionális üzenetszöveggel. Az irányítópult csak pontosan ezt a formát olvassa be. Az `smsto:` célként elutasításra kerül. | | `link.url` | Az `sms:` URI. Alapértelmezés: a `data` értéke. | | `fileId` | Nem engedélyezett. | | Kódolja | A rövid linket, amely egy oldalt nyit meg, az pedig átadja az üzenetet az üzenetküldő alkalmazásnak. | | Nyomtatás után | Szerkeszthető. Az üzenet módosításához küldje el a `data` vagy a `link.url` mezőt. A `data` önmagában is elég. | ```json Request body theme={null} { "qrType": "sms", "data": "sms:+14155550123?body=Table%2012" } ``` Hibák: * `422 Expected an SMS URI, e.g. "sms:+14155550123?body=Hello" for qrType "sms".` ## WiFi `qrType`: `"wifi"`. Irányítópult-útmutató: [WiFi QR-kód](https://docs.getqr.com/hu/qr-types/wifi.md). ```text theme={null} WIFI:T:;S:;P:;H:;; ``` | Mező | Működés | | - | - | | `data` | Kötelező. Tartsa meg a `T`, `S`, `P`, `H` sorrendet: az irányítópult szerkesztője és listája erre épít. Az SSID-ben és a jelszóban a `\`, `;`, `"` és `:` karaktert fordított perjellel escapelje. Nyílt hálózathoz használja a `T:nopass` értéket üres `P:` mezővel. A beolvasók elutasítják a `T:none` értéket. **Készítő:** az SSID kötelező, a jelszó legalább 8 karakter, kivéve `nopass` esetén. | | `link.url` | Beolvasáskor nem használatos. Alapértelmezés: a `data` értéke. | | `fileId` | Nem engedélyezett. | | Kódolja | A nyers `WIFI:` tartalmat, nem a rövid linket. A beolvasások nem követhetők. | | Nyomtatás után | **Nem szerkeszthető.** Az új `data` csak a későbbi letöltéseket módosítja. A kinyomtatott kódok a régi hálózatot tartják meg. | ```json Request body theme={null} { "qrType": "wifi", "data": "WIFI:T:WPA;S:Cafe Guest;P:espresso42;H:false;;" } ``` Hibák: * `422 Expected a Wi-Fi payload, e.g. "WIFI:T:WPA;S:MyNetwork;P:secret;H:false;" for qrType "wifi".` > [!WARNING] > > Kinyomtatott WiFi QR-kód típusát ne változtassa meg. A kinyomtatott kódok a régi hálózatot tartják meg. ## PDF, kép és videó `qrType`: `"pdf"`, `"image"` vagy `"video"`. Irányítópult-útmutatók: [PDF](https://docs.getqr.com/hu/qr-types/pdf.md), [Image](https://docs.getqr.com/hu/qr-types/image.md), [Video](https://docs.getqr.com/hu/qr-types/video.md). | Mező | Működés | | - | - | | `fileId` | A fájl. A típusnak megfelelő céllal töltse fel: `pdf`, `image` vagy `video`. `fileId` megadásakor a `link.url` a fájl URL-je lesz, és az abban küldött értéket a rendszer figyelmen kívül hagyja. | | `data` | Bármi, ami nem egy másik típus tartalma (`WIFI:`, `BEGIN:VCARD`, `sms:`, `mailto:`, JSON-objektum). Lehet üres is. | | `link.url` | `fileId` nélkül a `link.url` (vagy a `data`) külső célként szolgál. Ez működik, de az irányítópult nem mutat fájlt. | | Kódolja | A rövid linket, amely közvetlenül a fájlra irányít át. A PDF nyers fájlként nyílik meg, nem megjelenítő oldalon. | | Nyomtatás után | Szerkeszthető. A fájl cseréjéhez küldjön új `fileId` értéket. A régi fájl felszabadul. | QR-kódonként egy fájl: a PDF-csomagok és képgalériák az API-ban nem érhetők el. Lásd: [Az API-n keresztül nem támogatott](#az-api-n-keresztül-nem-támogatott). ```json pdf theme={null} { "qrType": "pdf", "data": "", "fileId": "file_9f8e7d6c5b4a", "title": "Brochure" } ``` ```json image theme={null} { "qrType": "image", "data": "", "fileId": "file_3c2b1a0f9e8d", "title": "Floor plan" } ``` ```json video theme={null} { "qrType": "video", "data": "", "fileId": "file_5e4d3c2b1a0f", "title": "Product demo" } ``` A fájl feltöltéséről és a `fileId` megszerzéséről lásd: [Fájlok](https://docs.getqr.com/hu/api/endpoints/files.md). ## vCard `qrType`: `"vcard"`. Irányítópult-útmutató: [vCard QR-kód](https://docs.getqr.com/hu/qr-types/vcard.md). | Mező | Működés | | - | - | | `data` | Kötelező. `BEGIN:VCARD` sorral kezdődő vCard 3.0 szöveg, a sorokat `\r\n` választja el (a `\n` is működik). | | `fileId` | Opcionális profilkép (`logo` cél), akkor használatos, ha a `data` nem tartalmaz `PHOTO` vagy `X-GETQR-IMAGE-FILEID` sort. | | `link.url` | Figyelmen kívül marad, és a hosztolt oldal lép a helyére. Hagyja el. | | Kódolja | A rövid linket, amely a hosztolt névjegyoldalt nyitja meg, névjegymentéssel (`.vcf` letöltés). | | Nyomtatás után | Szerkeszthető. Az oldal frissítéséhez küldjön új `data` értéket. | A landing oldal és a szerkesztő csak az alábbi sorformákat olvassa. Más változatokat, például a `TEL;CELL:` vagy az `EMAIL;TYPE=INTERNET:` formát, a rendszer tárolja, de nem jelennek meg az oldalon. * `N:;;;;`: vezeték- és keresztnév. **Készítő:** mindkettő kötelező, legfeljebb 40 karakter. * `FN: `: az oldal nem olvassa. Az irányítópult listájának címkéje ebből származik. * `ORG:` és `TITLE:`: 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:`: e-mail-cím. * `URL:`: weboldal. * `NOTE:`: összefoglaló. Escapelje a `\\`, `\n`, `\;` és `\,` karaktereket. **Készítő:** legfeljebb 200 karakter. * `ADR:;;;;;;`: cím. * `X-SOCIALPROFILE;TYPE=:` vagy `URL;TYPE=:`: közösségi linkek, platformonként egy sor. * `PHOTO;VALUE=URI:`: a profilkép URL-je. Erősebb bármely fájlazonosítónál. * `X-GETQR-IMAGE-FILEID:`: profilkép (`logo` cél). * `X-GETQR-PAGE-LOGO-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. Közösségi platformok: `facebook`, `whatsapp`, `instagram`, `youtube`, `tiktok`, `messenger`, `snapchat`, `linkedin`, `x`, `reddit`, `pinterest`, `telegram`, `wechat`, `viber`, `line`. ```json Request body theme={null} { "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:jane@acme.com\r\nURL:https://acme.com\r\nX-GETQR-LANDING-THEME:p|0\r\nEND:VCARD", "title": "Jane Doe" } ``` Hibák: * `422 Expected a vCard payload starting with "BEGIN:VCARD" for qrType "vcard".` ## Social Media `qrType`: `"social"`. Irányítópult-útmutató: [Social Media QR-kód](https://docs.getqr.com/hu/qr-types/social.md). | Mező | Működés | | - | - | | `data` | Kötelező. Egy objektumot kódoló JSON-karakterlánc. A `JSON.stringify` függvénnyel állítsa elő. | | `fileId` | Opcionális, legfelső szintű profilkép (`logo` cél). | | `link.url` | Figyelmen kívül marad, és a hosztolt oldal lép a helyére. Hagyja el. | | Kódolja | A rövid linket, amely a hosztolt közösségi oldalt nyitja meg. | | Nyomtatás után | Szerkeszthető. Az oldal frissítéséhez küldjön új `data` értéket. | A `data` mezői: | Mező | Típus | Megjegyzés | | - | - | - | | `firstName` | string | Az oldal címsora és az egyetlen megjelenő név. **Készítő:** kötelező, legfeljebb 40. | | `lastName` | string | Legfeljebb 40. Az oldalon nem jelenik meg. | | `summary` | string | Legfeljebb 200. | | `socialLinks` | `{ platform, url }[]` | A `platform` a [vCard közösségi platformjainak](#vcard) egyike. **Készítő:** minden platform csak egyszer. | | `customItems` | `{ name, url, logoFileId }[]` | **Készítő:** `name` legfeljebb 40, egy http(s) `url` és egy `logoFileId`. Összesen legalább egy közösségi link vagy egyéni elem. | | `fileId` | string | Profilkép (`logo` cél). A tartalék a legfelső szintű `fileId`. | | `imageUrl` | string | Külső profilkép URL-je, csak akkor használatos, ha nincs fájlazonosító. | | `pageLogoFileId` | string | Oldallogó (`logo` cél). | | `landingThemeMode` | `"preset" \| "custom"` | Alapértelmezés: `preset`. | | `landingPresetIndex` | 0–4 | Alapértelmezés: 0. | | `landingCustomBg`, `landingCustomButton`, `landingCustomIcon` | `#RRGGBB` | Akkor használatos, ha a mód `custom`. | ```json Request body theme={null} { "qrType": "social", "data": "{\"firstName\":\"Acme Coffee\",\"summary\":\"Follow us\",\"socialLinks\":[{\"platform\":\"instagram\",\"url\":\"https://instagram.com/acme\"}],\"customItems\":[]}" } ``` Hibák: * `422 Expected a JSON object describing the social profile page for qrType "social".` ## Multi-Link `qrType`: `"multilink"`. Irányítópult-útmutató: [Multi-Link QR-kód](https://docs.getqr.com/hu/qr-types/multi-link.md). | Mező | Működés | | - | - | | `data` | Kötelező. Egy objektumot kódoló JSON-karakterlánc. | | `fileId` | Opcionális, legfelső szintű profilkép (`logo` cél). | | `link.url` | Figyelmen kívül marad, és a hosztolt oldal lép a helyére. Hagyja el. | | Kódolja | A rövid linket, amely a hosztolt többlinkes oldalt nyitja meg. | | Nyomtatás után | Szerkeszthető. Az oldal frissítéséhez küldjön új `data` értéket. | A `data` mezői megegyeznek a [Social Media](#social-media) típuséval, azzal a különbséggel, hogy a `firstName`, `lastName` és `summary` helyett ezek szerepelnek: | Mező | Típus | Megjegyzés | | - | - | - | | `title` | string | Az oldal címsora. **Készítő:** kötelező, legfeljebb 40. | | `description` | string | Legfeljebb 200. | A `customItems` elemeiben a `logoFileId` opcionális: hiánya esetén egy tartalék ikon jelenik meg. **Készítő:** legalább egy közösségi link vagy egy nem üres egyéni elem. ```json Request body theme={null} { "qrType": "multilink", "data": "{\"title\":\"Acme links\",\"description\":\"Everything in one place\",\"socialLinks\":[],\"customItems\":[{\"name\":\"Shop\",\"url\":\"https://acme.com/shop\",\"logoFileId\":\"\"}]}" } ``` Hibák: * `422 Expected a JSON object describing the multi-link page for qrType "multilink".` ## Event `qrType`: `"event"`. Irányítópult-útmutató: [Event QR-kód](https://docs.getqr.com/hu/qr-types/event.md). | Mező | Működés | | - | - | | `data` | Kötelező. Egy objektumot kódoló JSON-karakterlánc. Az ismeretlen vagy érvénytelen értékek helyére az alapértékek kerülnek. | | `fileId` | A rendszer validálja (`logo` cél) és tárolja, de az eseményoldal a borítóképet csak a `data.fileId` mezőből olvassa. A borítókép azonosítóját a tartalomba tegye. | | `link.url` | Figyelmen kívül marad, és a hosztolt oldal lép a helyére. Hagyja el. | | Kódolja | A rövid linket, amely a hosztolt eseményoldalt nyitja meg, `.ics` letöltéssel. | | Nyomtatás után | Szerkeszthető. Az oldal frissítéséhez küldjön új `data` értéket. | A `data` mezői: | Mező | Típus | Megjegyzés | | - | - | - | | `name` | string | **Készítő:** kötelező. | | `eventType` | string | Az alábbi eseménytípusok egyike, vagy üres. | | `start`, `end` | `"YYYY-MM-DDTHH:mm"` | Helyi idő a `timezone` szerint. **Készítő:** mindkettő kötelező, a befejezés a kezdés után. | | `timezone` | IANA, például `"Europe/Berlin"` | Ez helyezi el a kezdést és a befejezést az `.ics` fájlban. Mindig küldje el: üres vagy ismeretlen zóna esetén az `.ics` UTC-ként kezeli az időpontokat. | | `street`, `zip`, `city`, `state`, `country` | string | **Készítő:** a `city` és a `country` kötelező, egyenként legfeljebb 40. | | `facilities` | string\[] | Azonosítók az alábbi listából. Az ismeretlen azonosítókat a rendszer elveti. | | `notes` | string | Szabad szöveg. | | `fileId` | string | Borítókép (`logo` cél). | | `pageLogoFileId` | string | Oldallogó (`logo` cél). | | `organizerName`, `organizerEmail`, `mobile`, `work` | string | `mobile` és `work` legfeljebb 40. | | `socialLinks` | `{ platform, url }[]` | A [vCard közösségi platformjai](#vcard), valamint a `website`. | | `ticketsUrl` | http(s) URL | Link a jegyvásárláshoz. | | `ticketsLabel` | string | Legfeljebb 20 karakter. A hosszabb feliratok levágódnak. Üresen az alapértelmezett felirat jelenik meg. | > [accordion] Eseménytípusok > > `conference`, `seminar`, `workshop`, `training`, `webinar`, `meetup`, `networking`, `corporateEvent`, `productLaunch`, `tradeShow`, `jobFair`, `fundraiser`, `charity`, `wedding`, `engagement`, `birthday`, `anniversary`, `babyShower`, `graduation`, `reunion`, `party`, `religious`, `funeralMemorial`, `ceremony`, `concert`, `festival`, `clubNight`, `theater`, `comedy`, `filmScreening`, `exhibition`, `sports`, `tournament`, `raceMarathon`, `fitnessClass`, `foodDrink`, `market`, `openHouse`, `community`, `schoolEvent`, `kids`, `travelTour` > [accordion] Szolgáltatások > > | Csoport | Azonosítók | > | - | - | > | Belépés | `freeEntry`, `idRequired`, `invitationOnly`, `plusOneAllowed`, `reEntryAllowed` | > | Életkor (egyet válasszon) | `adultsOnly`, `age18Plus`, `age21Plus`, `kidsWelcome` | > | Helyszínen | `parking`, `publicTransport`, `shuttle`, `wheelchairAccess`, `evCharging`, `wifi`, `foodDrinks`, `alcoholServed`, `atm`, `coatCheck`, `pool`, `phoneCharging`, `firstAid`, `wc` | > | Szabályok | `petsAllowed`, `noPets`, `smokingArea`, `noSmoking`, `noPhotos` | > | Öltözködési szabály (egyet válasszon) | `dressCasual`, `dressSmartCasual`, `dressBusiness`, `dressCocktail`, `dressThemed` | ```json Request body theme={null} { "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\"}" } ``` Hibák: * `422 Expected a JSON object describing the event page for qrType "event".` ## Fájlok a QR-kódokban Regisztrálja a fájlt a [Fájlok](https://docs.getqr.com/hu/api/endpoints/files.md) végponttal, töltse fel, majd adja át a `fileId` értékét. A felhasználásnak megfelelő célt válassza: * **`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. Azokat a fájlokat, amelyek soha nem kapcsolódnak QR-kódhoz, a rendszer egy türelmi idő után törli. `fileId` hibák, amelyeket létrehozáskor, illetve `PATCH` esetén kaphat, ha elküldi a `fileId` mezőt: | Állapot | Ok | | - | - | | `422 unprocessable_entity` | Ez a típus nem fogad fájlt. Csak a `pdf`, `image`, `video`, `vcard`, `social`, `multilink` és `event` fogad el fájlt. | | `404 not_found` | Nincs ilyen azonosítójú fájl. Előbb regisztrálja a `POST /api/v1/files` hívással. | | `422 unprocessable_entity` | A fájlt más célhoz töltötték fel. Például egy `image` feltöltés PDF QR-kódon, vagy egy `pdf`, `image` vagy `video` feltöltés vCard-fotóként. | | `422 unprocessable_entity` | A fájl regisztrálva van, de az `uploadUrl` címre történő feltöltés soha nem fejeződött be. | A tartalmon belüli fájlazonosítókat (`fileId`, `pageLogoFileId`, `customItems[].logoFileId`, `X-GETQR-*-FILEID` sorok) a rendszer nem validálja. Csak akkor jelennek meg, ha `logo` céllal töltötték fel őket. A QR-kód magáénak tekinti őket, így a takarítás nem törli őket. ## Típusváltás A `qrType` értékét a [QR-kód frissítése](https://docs.getqr.com/hu/api/endpoints/qr-codes.md#qr-kód-frissítése) végponttal módosíthatja. Az új típusnak megfelelő `data` értéket küldjön: a tárolt tartalom a régi típushoz tartozik, ezért a nélküle végzett váltást a rendszer elutasítja. Frissítés után a cél ebben a sorrendben dől el: 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. Mit eredményez az egyes váltások: * **`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 irányítópulton készült statikus QR-kódoknak nincs rövid linkjük, ezért a `link.url` módosítása `422` hibát ad. ## Az API-n keresztül nem támogatott Ezek az irányítópult-funkciók nem részei a v1 API-nak. Az ismeretlen mezőket a rendszer hiba nélkül elveti, így elküldésüknek nincs hatása. | Mező | Leírás | | - | - | | `appName` | Egy App Link QR-kód megjelenített neve. Az API-n keresztül létrehozott App Link QR-kódok az irányítópult listájában az áruház URL-jét mutatják. | | `isStatic` | Statikus QR-kód rövid link nélkül. Az API által létrehozott minden QR-kódnak van rövid linkje, így nyomtatás után is szerkeszthető és követhető (a `wifi` kivételével). | | `pdfBundle` | PDF QR-kód két vagy több fájllal. Az API csak egyfájlos PDF QR-kódokat hoz létre. | | `imageGallery` | Image QR-kód két vagy több képpel. Az API csak egyképes QR-kódokat hoz létre. | Az irányítópulton készült csomagok és galériák az API-n keresztül is lekérhetők, szüneteltethetők és törölhetők, de a fájljaik nem módosíthatók rajta keresztül. ## Gyakori problémák > [accordion] 422 Invalid destination URL > > A `link.url` olyan sémát használ, amelyre a rövid link nem tud átirányítani, például `geo:`, `smsto:`, `matmsg:` vagy `tel:`. Használja az ezen az oldalon leírt formátumokat. > [accordion] 400 Missing destination URL > > A `data` üres, és nincs `link.url`. Az `app` típusnál adja meg legalább a `link.ios`, `link.android`, `link.url` vagy `data` egyikét. > [accordion] A válaszban a data egy rövid link, nem az én URL-em > > Link típusoknál a tárolt `data` a rövid link. A célt az `url` mezőből olvassa ki. > [accordion] A landing oldalról hiányoznak adatok a tartalmamból > > Az oldal csak az adott típusnál felsorolt mezőket és sorformákat olvassa. A többi mezőt a rendszer tárolja, de nem jeleníti meg. ## Következő lépések > [card] [QR-kódok](https://docs.getqr.com/hu/api/endpoints/qr-codes.md) > [card] [Fájlok](https://docs.getqr.com/hu/api/endpoints/files.md) > [card] [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md) > [card] [Hozzáférési szabályok](https://docs.getqr.com/hu/api/guides/access-rules.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.