> ## 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ódok > QR-kódok létrehozása, listázása, frissítése, szüneteltetése, másolása, törlése és letöltése. > [!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. A GetQR-ben egy QR-kód a képből és egy rövid linkből áll, amelyen keresztül a célhoz vezet. A QR-kód létrehozásakor a rövid linkje is létrejön, így a célt később is módosíthatja a kód újranyomtatása nélkül. | Metódus | Útvonal | Leírás | | - | - | - | | `GET` | `/api/v1/qrs` | [QR-kódok listázása](#qr-kódok-listázása) | | `POST` | `/api/v1/qrs` | [QR-kód létrehozása](#qr-kód-létrehozása) | | `GET` | `/api/v1/qrs/{qrId}` | [QR-kód lekérése](#qr-kód-lekérése) | | `PATCH` | `/api/v1/qrs/{qrId}` | [QR-kód frissítése](#qr-kód-frissítése) | | `PUT` | `/api/v1/qrs/{qrId}` | [A szüneteltetett állapot beállítása](#a-szüneteltetett-állapot-beállítása) | | `POST` | `/api/v1/qrs/{qrId}/pause` | [QR-kód szüneteltetése](#qr-kód-szüneteltetése) | | `POST` | `/api/v1/qrs/{qrId}/activate` | [QR-kód újraaktiválása](#qr-kód-újraaktiválása) | | `POST` | `/api/v1/qrs/{qrId}/duplicate` | [QR-kód másolása](#qr-kód-másolása) | | `DELETE` | `/api/v1/qrs/{qrId}` | [QR-kód törlése](#qr-kód-törlése) | | `GET` | `/api/v1/qrs/{qrId}/download` | [QR-kód képének letöltése](#qr-kód-képének-letöltése) | > [card] [QR-kód-adatok típusonként](https://docs.getqr.com/hu/api/guides/qr-types.md) > > A `data` formátuma mind a 16 típushoz. > [card] [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md) > > Pontstílusok, színek, keretek és logók. > [card] [Hozzáférési szabályok](https://docs.getqr.com/hu/api/guides/access-rules.md) > > Ütemezés, beolvasási korlát és jelszó. Egy QR-kód beolvasási statisztikáiért lásd: [Analitika](https://docs.getqr.com/hu/api/endpoints/analytics.md). ## A QR-kód objektum Minden QR-kód-végpont ezzel az objektummal válaszol, kivéve a [törlést](#qr-kód-törlése) és a [letöltést](#qr-kód-képének-letöltése). A lista ilyen objektumok tömbjét adja vissza. **id** `string` A QR-kód egyedi azonosítója, például `qr_1EPcVfeHZAY2iNoVLsgW2Aqf`. **qrType** `string` A QR-kód típusa, például `website`. Mind a 16 értéket lásd: [QR-kód-adatok típusonként](https://docs.getqr.com/hu/api/guides/qr-types.md). **title** `string | null` A QR-kód neve, amely az irányítópulton jelenik meg. **description** `string | null` Szabad szöveges megjegyzés a QR-kódhoz. **data** `string` A tárolt tartalom. A `wifi`, `vcard`, `social`, `multilink`, `event` és `sms` típusnál az Ön által küldött tartalom. Minden más típusnál a rövid link, ezért a célt az `url` mezőből olvassa ki. **archived** `boolean` `true`, ha a QR-kód szünetel. **isStatic** `boolean` `true` egy irányítópulton készült statikus QR-kódnál, amelynek nincs rövid linkje. Az API mindig dinamikus QR-kódokat hoz létre. **shortLink** `string | null` A teljes rövid link, például `https://getqr.sh/x7Kd2p1`. **domain** `string | null` A rövid link domainje. **key** `string | null` A rövid link azonosítója (slug). **keyIsCustom** `boolean` `true`, ha az azonosítót választották, nem generálták. **url** `string | null` A cél, ahová a rövid link átirányít. **ios** `string | null` Cél az iOS-es látogatóknak, `app` QR-kódoknál. **android** `string | null` Cél az androidos látogatóknak, `app` QR-kódoknál. **scans** `integer` A beolvasások teljes száma. **access** `object` Hozzáférési szabályok. Magát a jelszót a rendszer soha nem adja vissza. Lásd: [Hozzáférési szabályok](https://docs.getqr.com/hu/api/guides/access-rules.md). **properties** **passwordProtected** `boolean` Meg kell-e adniuk a látogatóknak jelszót. **activeAt** `string | null` Ütemezett kezdés, ISO 8601. **pauseAt** `string | null` Ütemezett befejezés, ISO 8601. **scanLimit** `integer | null` A beolvasások maximális száma. **designKind** `string` Csak olvasható. A `custom` olyan dizájn, amelyet az API teljes egészében szerkeszthet. A `branded` és az `ai` az irányítópulton készült Branded vagy AI dizájn. Az API nem tudja szerkeszteni a képét, de megtartja, amikor más mezőket módosít. **design** `object` A tárolt dizájn: `styles`, `frameOptions` és `logoOptions`, mindegyik objektum vagy `null`. Felépítésük megegyezik a kérésmezőkével, így vissza is küldheti őket. Lásd: [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md). **file** `object | null` Egy `pdf`, `image` vagy `video` QR-kód fájlja: `id`, `name` és `size` (bájtban). **appName** `string | null` Csak olvasható. Egy irányítópulton készült `app` QR-kód megjelenített neve. **pdfBundle** `object | null` Csak olvasható. Az irányítópulton készült, több fájlt tartalmazó `pdf` QR-kód: `title`, `layout` és `files`. **imageGallery** `object | null` Csak olvasható. Az irányítópulton készült, több képet tartalmazó `image` QR-kód: `title`, `layout` és `files`. **createdAt** `string` Létrehozás dátuma, ISO 8601. **updatedAt** `string` Utolsó frissítés dátuma, ISO 8601. A titkos adatokat és a belső azonosítókat (`password`, `userId`, `workspaceId`, `projectId`) a rendszer soha nem adja vissza. ```json theme={null} { "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf", "qrType": "website", "title": "Landing page", "description": null, "data": "https://getqr.sh/x7Kd2p1", "archived": false, "isStatic": false, "shortLink": "https://getqr.sh/x7Kd2p1", "domain": "getqr.sh", "key": "x7Kd2p1", "keyIsCustom": false, "url": "https://example.com", "ios": null, "android": null, "scans": 128, "access": { "passwordProtected": false, "activeAt": null, "pauseAt": null, "scanLimit": null }, "designKind": "custom", "design": { "styles": { "dotsOptions": { "type": "rounded", "color": "#1E40AF" }, … }, "frameOptions": { "id": "card", "text": "Scan me!", … }, "logoOptions": { "type": "suggested", "id": "logo-website-3", "scalePercent": 25 } }, "file": null, "appName": null, "pdfBundle": null, "imageGallery": null, "createdAt": "2026-08-01T10:00:00.000Z", "updatedAt": "2026-08-01T10:00:00.000Z" } ``` ## QR-kódok listázása `GET /api/v1/qrs` A munkaterület QR-kódjait adja vissza, oldalanként. **page** `integer` (default: 1) A visszaadandó oldal, 1 vagy nagyobb. **pageSize** `integer` (default: 100) QR-kódok oldalanként, 1 és 100 között. Nagyobb értéket a rendszer elutasít. **search** `string` A QR-kód címében keres. A 2 karakternél hosszabb lekérdezések a tárolt `data` értékében is keresnek. Link típusoknál a tárolt `data` a rövid link, ezért a cél-URL-ekre nem lehet keresni. **sortBy** `string` (default: createdAt) A rendezés mezője: `createdAt`, `updatedAt`, `clicks` (összes beolvasás), `lastClicked` (legutóbbi beolvasás) vagy `type`. A `type` mindig csökkenő sorrendbe rendez, és figyelmen kívül hagyja a `sortOrder` paramétert. **sortOrder** `string` (default: desc) A rendezés iránya: `asc` vagy `desc`. **showArchived** `boolean` (default: false) A szüneteltetett QR-kódokat is visszaadja. **onlyArchived** `boolean` (default: false) Csak a szüneteltetett QR-kódokat adja vissza. Felülírja a `showArchived` paramétert. A logikai paraméterek a `true` vagy a `false` karakterláncot fogadják. Kérje le a következő oldalt, amíg a `pagination.hasMore` értéke `true`. Lásd: [Lapozás](https://docs.getqr.com/hu/api/introduction.md#lapozás). ```bash cURL theme={null} curl "https://getqr.com/api/v1/qrs?page=1&pageSize=100" \ -H "Authorization: Bearer $GETQR_API_KEY" ``` ```json 200 theme={null} { "data": [ { "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf", "qrType": "website", "title": "Landing page", "shortLink": "https://getqr.sh/x7Kd2p1", "url": "https://example.com", "scans": 128, "…": "…" } ], "pagination": { "page": 1, "pageSize": 100, "total": 1, "hasMore": false } } ``` ## QR-kód létrehozása `POST /api/v1/qrs` Egyszerre hozza létre a QR-kódot és a rövid linkjét. `201 Created` kóddal válaszol, és visszaadja az új [QR-kódot](#a-qr-kód-objektum). **Idempotency-Key** `string` Saját újrapróbálkozási token. Ha 24 órán belül ugyanazzal a kulccsal ismétli meg a kérést, az eredeti választ kapja vissza, és nem jön létre második QR-kód. Lásd: [Újrapróbálkozások és duplikátumok](#újrapróbálkozások-és-duplikátumok). **qrType** `string` *required* Mit kódol a QR-kód. Ez határozza meg a `data` kötelező formátumát is. Lehetséges értékek: `website`, `pdf`, `image`, `video`, `whatsapp`, `social`, `wifi`, `app`, `feedback`, `vcard`, `sms`, `payment`, `location`, `multilink`, `email`, `event`. **data** `string` *required* A típus tartalma, amelyet a rendszer a `qrType` alapján ellenőriz. Üres karakterlánc esetén az ellenőrzés kimarad. Az egyes típusok formátumát lásd: [QR-kód-adatok típusonként](https://docs.getqr.com/hu/api/guides/qr-types.md). **link** `object` A rövid link, amelyen keresztül a QR-kód a célhoz vezet. Opcionális: ha elhagyja, a `link.url` a `data` értékét követi. **properties** **url** `string` A cél, ahová a rövid link átirányít. Ha hiányzik vagy üres, a `data` értékét kapja. Ha mindkettőt elküldi, és eltérnek, a `link.url` az erősebb. A `vcard`, `social`, `multilink` és `event` QR-kódok mindig a hosztolt oldalukra mutatnak, a `fileId` értékkel rendelkező `pdf`, `image` és `video` QR-kódok pedig a fájlra. Elfogadott sémák: `http:`, `https:`, `wifi:`, `mailto:`, `sms:`, `begin:`. **domain** `string` A rövid link domainje. A munkaterület egyik élő domainjének kell lennie: más domain `403`, a még nem élő domain `422` hibát kap. Alapértelmezés: a munkaterület alapértelmezett domainje. **key** `string` A rövid link azonosítója, 3–15 karakter, kisbetűsen tárolva. A nem engedélyezett azonosító `422`, a foglalt `409` hibát kap. Ha elhagyja, a rendszer egy véletlenszerű, 7 karakteres azonosítót generál. **ios** `string | null` Cél-URL az iOS-es látogatóknak, `app` QR-kódoknál. **android** `string | null` Cél-URL az androidos látogatóknak, `app` QR-kódoknál. **title** `string | null` A linkelőnézet címe (`og:title`), a rövid linken tárolva. Eltér a QR-kód saját `title` mezőjétől. Jelenleg semmi sem jeleníti meg. **description** `string | null` A linkelőnézet leírása (`og:description`), a rövid linken tárolva. Jelenleg semmi sem jeleníti meg. **expiresAt, expiredUrl** `—` Ebben az API-ban nem érhető el: bármelyik elküldése `422` hibát ad. Ha a QR-kódot egy adott időpontban le szeretné állítani, használja az `access.pauseAt` mezőt. **title** `string` A QR-kód neve, amely az irányítópulton jelenik meg. A szélső szóközök levágása után 1–40 karakter. Ha elhagyja, a QR-kód cím nélkül marad. **description** `string` Szabad szöveges megjegyzés a QR-kódhoz. Legfeljebb 280 karakter. **fileId** `string` Egy `pdf`, `image` vagy `video` QR-kód fájlja, a megfelelő céllal feltöltve. A `vcard`, `social` és `multilink` típusnál opcionális profilkép, `logo` céllal feltöltve. Az `event` is elfogadja, de az oldala a borítóképet a `data.fileId` mezőből olvassa. Más típusok `422` hibát kapnak. Előbb töltse fel a fájlt a [Fájlok](https://docs.getqr.com/hu/api/endpoints/files.md) végponttal. Lásd: [Fájlok a QR-kódokban](https://docs.getqr.com/hu/api/guides/qr-types.md#fájlok-a-qr-kódokban). **templateId** `string` A [sablon](https://docs.getqr.com/hu/api/endpoints/templates.md), amelynek dizájnja az új QR-kódra kerül. Az elküldött dizájnmezők erre olvadnak rá. Branded vagy AI dizájnú sablon esetén `422` (`art_template_unsupported`) a válasz. Ismeretlen vagy más munkaterülethez tartozó sablon esetén `404`. **styles** `object` Pont- és sarokformák és színek. Lásd: [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md). **frameOptions** `object` A QR-kód köré rajzolt keret és a cselekvésre ösztönző szöveg. Lásd: [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md). **logoOptions** `object` Logó középen: javasolt logó vagy saját, `logo` céllal feltöltött fájl. Az ismeretlen fájlt, a befejezetlen feltöltést vagy a más célhoz feltöltött fájlt a rendszer elutasítja. Lásd: [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md). **access** `object` Ütemezés, beolvasási korlát és jelszavas védelem. Lásd: [Hozzáférési szabályok](https://docs.getqr.com/hu/api/guides/access-rules.md). **properties** **activeAt** `string | null` Ütemezett kezdés, ISO 8601. **pauseAt** `string | null` Ütemezett befejezés, ISO 8601. **scanLimit** `integer | null` A beolvasások maximális száma, pozitív egész szám. **password** `string | null` A jelszó, amelyet a látogatóknak meg kell adniuk. Elküldésével a védelem bekapcsol. **passwordProtected** `boolean` Ki- vagy visszakapcsolja a védelmet, a tárolt jelszó megtartásával. **archived** `boolean` Szünetel-e a QR-kód. A `true` szüneteltetett állapotban hozza létre: a beolvasások a cél helyett a szüneteltetési oldalt mutatják. Az ismeretlen mezőket a rendszer hiba nélkül elveti. Lásd: [Az API-n keresztül nem támogatott](https://docs.getqr.com/hu/api/guides/qr-types.md#az-api-n-keresztül-nem-támogatott). ```bash cURL theme={null} curl -X POST "https://getqr.com/api/v1/qrs" \ -H "Authorization: Bearer $GETQR_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: landing-page-2026-08" \ -d '{ "qrType": "website", "data": "https://example.com", "title": "Landing page", "access": { "scanLimit": 500 } }' ``` ```json 201 theme={null} { "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf", "qrType": "website", "title": "Landing page", "data": "https://getqr.sh/x7Kd2p1", "shortLink": "https://getqr.sh/x7Kd2p1", "url": "https://example.com", "scans": 0, "access": { "passwordProtected": false, "activeAt": null, "pauseAt": null, "scanLimit": 500 }, "…": "…" } ``` ### Újrapróbálkozások és duplikátumok * **Kulccsal.** `Idempotency-Key` fejléccel a válasz 24 órán át újra visszaadható. * **Kulcs nélkül.** A 30 másodpercen belül elküldött azonos törzset a rendszer duplikátumnak tekinti. * **Ismételt válaszok.** Az ismételt válasz a tárolt választ adja vissza, `x-idempotent-replay: true` értékkel. Egy új QR-kód `false` értéket ad. * **Folyamatban.** Ha egy második kérés érkezik, miközben az első még fut, `409 conflict` a válasz. * **Hibák.** A sikertelen létrehozás azonnal felszabadítja a kulcsot, így ugyanazzal a kulccsal újra próbálkozhat. * **Nem garantált.** Ha a védelem nem érhető el, a létrehozás védelem nélkül megy végbe. Lásd még: [Idempotencia](https://docs.getqr.com/hu/api/introduction.md#idempotencia). ## QR-kód lekérése `GET /api/v1/qrs/{qrId}` Egy [QR-kódot](#a-qr-kód-objektum) ad vissza a rövid linkjével, hozzáférési szabályaival, dizájnjával és – fájlalapú típusoknál – a fájljával. **qrId** `string` *required* A QR-kód azonosítója, a lista vagy a létrehozás válaszából. ```bash cURL theme={null} curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf" \ -H "Authorization: Bearer $GETQR_API_KEY" ``` A válasz a teljes [QR-kód objektum](#a-qr-kód-objektum). ## QR-kód frissítése `PATCH /api/v1/qrs/{qrId}` Módosítja a QR-kód tartalmát, célját, dizájnját vagy hozzáférési szabályait. Csak a módosítani kívánt mezőket küldje el. A frissített [QR-kóddal](#a-qr-kód-objektum) válaszol. **qrId** `string` *required* A QR-kód azonosítója. A törzs ugyanazokat a mezőket fogadja, mint a [QR-kód létrehozása](#qr-kód-létrehozása), mindet opcionálisan, a következő eltérésekkel: * **`templateId`.** Nem elfogadott. * **`link`.** Részleges. Ha elhagyja a `link.url` mezőt, a jelenlegi cél megmarad. A `link.domain` és a `link.key` `422` hibát kap: a kinyomtatott kód a rövid linket kódolja, ezért más rövid linkhez hozzon létre új QR-kódot. * **`data`.** A rendszer csak akkor ellenőrzi az eredményül kapott típus alapján, ha a `data` vagy a `qrType` változik. A `qrType` megfelelő `data` nélküli váltását a rendszer elutasítja. Lásd: [Típusváltás](https://docs.getqr.com/hu/api/guides/qr-types.md#típusváltás). * **Dizájn.** A `styles`, `frameOptions` és `logoOptions` objektum a tárolt dizájnba olvad, így egy részleges objektum csak azt módosítja, amit megnevez. Másik logó választásakor az lecseréli a régit, de a mérete megmarad. * **`access`.** Minden kulcs akkor érvényesül, ha jelen van. A `null` törli az adott szabályt. A hozzáférési szabályok az `access` alá tartoznak: ha a `link` alatt küldi őket, `422` hibát kap. * **`archived`.** A QR-kódot és a rövid linkjét együtt szünetelteti vagy aktiválja újra, ahogy a [szüneteltetés](#qr-kód-szüneteltetése) és az [újraaktiválás](#qr-kód-újraaktiválása). ```bash cURL theme={null} curl -X PATCH "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf" \ -H "Authorization: Bearer $GETQR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "title": "Autumn campaign", "access": { "password": "s3cr3t", "passwordProtected": true } }' ``` ```json 200 theme={null} { "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf", "title": "Autumn campaign", "access": { "passwordProtected": true, "activeAt": null, "pauseAt": null, "scanLimit": null }, "…": "…" } ``` Hogy az egyes típusoknál mit módosíthat nyomtatás után, azt a [QR-kód-adatok típusonként](https://docs.getqr.com/hu/api/guides/qr-types.md) oldal sorolja fel. ## A szüneteltetett állapot beállítása `PUT /api/v1/qrs/{qrId}` Közvetlenül beállítja a szüneteltetett állapotot. A [szüneteltetés](#qr-kód-szüneteltetése) és az [újraaktiválás](#qr-kód-újraaktiválása) ugyanezt teszi, és egyértelműbben olvasható. **qrId** `string` *required* A QR-kód azonosítója. **archived** `boolean` *required* `true` a QR-kód szüneteltetéséhez, `false` az újraaktiválásához. ```bash cURL theme={null} curl -X PUT "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf" \ -H "Authorization: Bearer $GETQR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "archived": true }' ``` ```json 200 theme={null} { "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf", "archived": true, "…": "…" } ``` ## QR-kód szüneteltetése `POST /api/v1/qrs/{qrId}/pause` Megállítja, hogy a QR-kód a céljához vezessen: a beolvasások helyette a szüneteltetési oldalt mutatják. A kinyomtatott kód és a rövid linkje érvényes marad. Nincs kéréstörzs. **qrId** `string` *required* A QR-kód azonosítója. ```bash cURL theme={null} curl -X POST "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/pause" \ -H "Authorization: Bearer $GETQR_API_KEY" ``` ```json 200 theme={null} { "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf", "archived": true, "…": "…" } ``` ## QR-kód újraaktiválása `POST /api/v1/qrs/{qrId}/activate` Egy szüneteltetett QR-kódot ismét a céljához vezet. Az ütemezés és a beolvasási korlát továbbra is érvényes. Nincs kéréstörzs. **qrId** `string` *required* A QR-kód azonosítója. ```bash cURL theme={null} curl -X POST "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/activate" \ -H "Authorization: Bearer $GETQR_API_KEY" ``` ```json 200 theme={null} { "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf", "archived": false, "…": "…" } ``` ## QR-kód másolása `POST /api/v1/qrs/{qrId}/duplicate` Másolatot készít ugyanazzal a tartalommal és dizájnnal. Nincs kéréstörzs. `201 Created` kóddal válaszol, és visszaadja az új [QR-kódot](#a-qr-kód-objektum). **qrId** `string` *required* A másolandó QR-kód azonosítója. * **Rövid link.** A másolat saját rövid linket kap, véletlenszerű azonosítóval a munkaterület alapértelmezett domainjén, nem az eredeti domainjén. A beolvasásait a rendszer külön számolja. * **Cím.** A cím ` (Copy)` utótagot kap. Az eredmény legfeljebb 40 karakter: a hosszú címet a rendszer előbb lerövidíti. A cím nélküli QR-kód cím nélkül marad. * **Nem másolódik.** A hozzáférési szabályok (jelszó, ütemezés, beolvasási korlát) és a szüneteltetett állapot. A másolat mindig aktív. * **Fájlok.** A PDF- és képfájlok – a csomagok és galériák fájljait is beleértve – átmásolódnak, így a másolathoz tartoznak. A videófájlok és a dizájnfájlok, például a logók, közösek az eredetivel. ```bash cURL theme={null} curl -X POST "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/duplicate" \ -H "Authorization: Bearer $GETQR_API_KEY" ``` ```json 201 theme={null} { "id": "qr_7Hk2PqWmX9cTnV4sLbR8YdZe", "title": "Landing page (Copy)", "shortLink": "https://getqr.sh/p2Wq9dL", "url": "https://example.com", "archived": false, "scans": 0, "…": "…" } ``` ## QR-kód törlése `DELETE /api/v1/qrs/{qrId}` Törli a QR-kódot és a rövid linkjét. A törölt azonosítóval válaszol. > [!WARNING] > > A törlés végleges. A kinyomtatott kód és a rövid linkje megszűnik működni, és a beolvasási előzmények többé nem érhetők el. Ha még szüksége lehet a QR-kódra, inkább [szüneteltesse](#qr-kód-szüneteltetése). **qrId** `string` *required* A QR-kód azonosítója. **id** `string` A törölt QR-kód azonosítója. **deleted** `boolean` Mindig `true`. ```bash cURL theme={null} curl -X DELETE "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf" \ -H "Authorization: Bearer $GETQR_API_KEY" ``` ```json 200 theme={null} { "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf", "deleted": true } ``` ## QR-kód képének letöltése `GET /api/v1/qrs/{qrId}/download` Elkészíti a QR-kód képét a dizájnjával, és visszaadja a fájlt. **qrId** `string` *required* Az elkészítendő QR-kód azonosítója, a lista vagy a létrehozás válaszából. **format** `string` (default: jpg) Kimeneti formátum: `jpg`, `png`, `svg`, `pdf` (egy A4-es oldal) vagy `eps`. Branded vagy AI dizájn csak `jpg`, `png` vagy `pdf` formátumban tölthető le. **resolution** `integer` (default: 1024) A kép mérete pixelben: `1024`, `2048` vagy `4096`. Az `svg` és a `pdf` figyelmen kívül hagyja. Branded vagy AI dizájn csak `1024` méretben tölthető le. | `format` | `Content-Type` | Fájlnév | | - | - | - | | `jpg` | `image/jpeg` | `-<resolution>px.jpg` | | `png` | `image/png` | `<title>-<resolution>px.png` | | `svg` | `image/svg+xml` | `<title>.svg` | | `pdf` | `application/pdf` | `<title>.pdf` | | `eps` | `application/postscript` | `<title>-<resolution>px.eps` | * **Törzs.** A válasz törzse maga a fájl. A javasolt fájlnév a `Content-Disposition` fejlécben található; a címből képződik, cím nélküli QR-kódnál `qr-code`. * **Gyorsítótárazás.** A válaszok `ETag` és `Cache-Control: private, max-age=3600, must-revalidate` fejlécet tartalmaznak. Küldje vissza az `ETag` értékét az `If-None-Match` fejlécben, és `304 Not Modified` választ kap, ha a QR-kód nem változott. * **Hibák.** A nem támogatott formátum vagy felbontás `400 bad_request` hibát kap. A hibaüzenet megnevezi az okot: `qr_download_invalid_format`, `qr_download_invalid_resolution`, `qr_download_art_format_unsupported` vagy `qr_download_art_resolution_unsupported`. ```bash cURL theme={null} curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/download?format=png&resolution=1024" \ -H "Authorization: Bearer $GETQR_API_KEY" \ --output qr-code.png ``` ```http 200 theme={null} HTTP/1.1 200 OK Content-Type: image/png Content-Disposition: attachment; filename="landing-page-1024px.png" ETag: "9f2c0e1b5a7d43c8b016e2f4a9d5c3718be40f92" Cache-Control: private, max-age=3600, must-revalidate <binary image data> ``` ## Hozzáférési szabályok Küldjön egy `access` objektumot létrehozáskor vagy frissítéskor, hogy kezdést és befejezést ütemezzen, korlátozza a beolvasások számát, vagy jelszót követeljen meg. Az elhagyott szabályok változatlanok maradnak, a `null` pedig törli az adott szabályt. A teljes működést példákkal a [Hozzáférési szabályok](https://docs.getqr.com/hu/api/guides/access-rules.md) oldal írja le. ## Dizájnobjektumok A `styles`, `frameOptions` és `logoOptions` a pont- és sarokformákat, a színeket, a keretet és a logót állítja be. Ugyanúgy működnek a QR-kódoknál, a [sablonoknál](https://docs.getqr.com/hu/api/endpoints/templates.md) és a [tömeges létrehozásnál](https://docs.getqr.com/hu/api/endpoints/bulk-qr-creations.md). Az ismeretlen formákat, kereteket vagy logókat a rendszer elutasítja. Az összes elfogadott értéket és egy kidolgozott példát a [Testreszabás](https://docs.getqr.com/hu/api/guides/customization.md) oldalon talál. ## Gyakori problémák > [accordion] 422-es hiba jelszó, ütemezés vagy beolvasási korlát beállításakor > > A szabályt az `access` alatt küldje, ne a `link` alatt. > [accordion] 422-es hiba a link.domain vagy a link.key módosításakor > > A rövid link létrehozás után nem módosítható, mert a kinyomtatott kód azt kódolja. Hozzon létre helyette új QR-kódot. > [accordion] 422 "Expected … for qrType" > > A `data` nem felel meg a `qrType` formátumának. Ellenőrizze a típust a [QR-kód-adatok típusonként](https://docs.getqr.com/hu/api/guides/qr-types.md) oldalon. > [accordion] 409 conflict QR-kód létrehozásakor > > Egy azonos létrehozás még fut, vagy a `link.key` foglalt. Próbálja újra, miután az első kérés befejeződött. `Idempotency-Key` használatakor az újrapróbálkozás az eredeti QR-kódot adja vissza. > [accordion] A letöltés JPEG, nem PNG > > A paraméterek neve `format` és `resolution`, és a `format` alapértéke `jpg`. Küldje el a `format=png` paramétert. > [accordion] 404-es hiba egy QR-kódra, amelyet látok az irányítópulton > > Minden kérés az API-kulcs munkaterületében fut. Ellenőrizze, hogy a QR-kód ehhez a munkaterülethez tartozik-e. Lásd: [Hitelesítés](https://docs.getqr.com/hu/api/authentication.md). ## Következő lépések > [card] [QR-kód-adatok típusonként](https://docs.getqr.com/hu/api/guides/qr-types.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) > [card] [Analitika](https://docs.getqr.com/hu/api/endpoints/analytics.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.