> ## 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. # Testreszabás > QR-kódok formázása az API-n keresztül: pont- és sarokformák, színek, keretek és logók. > [!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 QR-kód megjelenését az opcionális `styles`, `frameOptions` és `logoOptions` objektummal szabhatja testre létrehozáskor vagy frissítéskor. Minden mező opcionális, és amit elhagy, arra az alapértékek érvényesek. Ugyanez a három objektum működik a [QR-kódoknál](https://docs.getqr.com/hu/api/endpoints/qr-codes.md), 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 `422` hibával elutasítja. ## Példa dizájnobjektum ```json theme={null} { "styles": { "dotsOptions": { "type": "rounded", "color": "#000000" }, "backgroundOptions": { "color": "#ffffff" }, "cornersSquareOptions": { "type": "dot", "color": "#000000" }, "cornersDotOptions": { "type": "dot", "color": "#000000" } }, "frameOptions": { "id": "card", "text": "Scan me!", "color": "#000000", "textColor": "#ffffff" }, "logoOptions": { "type": "suggested", "id": "logo-google", "scalePercent": 25 } } ``` Küldje el a QR-kód többi adatával együtt: ```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", "styles": { "dotsOptions": { "type": "rounded", "color": "#1E40AF" } }, "frameOptions": { "id": "card", "text": "Scan me!" }, "logoOptions": { "type": "suggested", "id": "logo-website-3" } }' ``` ## Stílusok A `styles` objektum a minta formáit és színeit állítja be. | Mező | Értékek | | - | - | | `dotsOptions.type` | A test pontjainak alakja: `square`, `dots`, `rounded`, `classy`, `classy-rounded`, `extra-rounded` | | `cornersSquareOptions.type` | A saroknégyzet (szemkeret) alakja: `square`, `rounded`, `dot`, `classy-rounded` | | `cornersDotOptions.type` | A sarokpont (szembogár) alakja: `square`, `dot`, `dots`, `rounded`, `classy` | | `dotsOptions.color` | Előtérszín. Alapértelmezés: `#000000`. | | `backgroundOptions.color` | Háttérszín. Alapértelmezés: `#ffffff`. | | `cornersSquareOptions.color`, `cornersDotOptions.color` | Elfogadott, de nincs hatása: a sarkok mindig a `dotsOptions.color` színt használják. | * **Színek.** Csak hexadecimális értékek: `#RGB` vagy `#RRGGBB`. * **Hibajavítás.** Mindig `Q`, és nem adható meg. A `styles.qrOptions` elküldése `422` hibát ad. * **Branded és AI dizájnok.** Az API-n keresztül nem állíthatók be. A `styles.logoQrArt` elküldése `422` hibát ad. * **Tartalom.** A `styles.data` mezőt a rendszer figyelmen kívül hagyja. A kép mindig a QR-kód tartalmát kódolja. > [!TIP] > > Tartson elegendő kontrasztot az előtér- és a háttérszín között: sötét előteret világos háttéren. Az alacsony kontrasztú kódok beolvasása meghiúsulhat. Lásd: [Színek](https://docs.getqr.com/hu/design/colors.md). ## Keretek A `frameOptions` objektum díszes keretet ad a QR-kód köré, cselekvésre ösztönző felirattal. | Mező | Leírás | | - | - | | `id` | Kötelező, ha elküldi a `frameOptions` objektumot. A keret típusa az alábbi listákból. A `none` azt jelenti, hogy nincs keret. | | `text` | Cselekvésre ösztönző felirat, legfeljebb 12 karakter. Alapértelmezés: `Scan me!`. | | `color` | A keret színe, hexadecimálisan. | | `textColor` | A felirat színe, hexadecimálisan. Feliratos keretnél el kell térnie a `color` értékétől, kivéve, ha a színpár a keret beépített színbeállításainak egyike. | | `borderColor` | A szegély színe, hexadecimálisan. | | `fingerPrintColor` | A keret ikonjának kiemelőszíne, hexadecimálisan. | > [accordion] Általános keretek > > `none`, `card`, `card-1`, `card-2`, `card-3`, `card-4`, `card-5`, `card-7`, `card-8`, `card-9`, `card-10`, `card-11`, `card-12`, `card-13`, `card-14`, `card-15`, `card-hor`, `wreath`, `envelope`, `waitress`, `coffee-cup`, `scooter`, `clipboard` > > A `card-hor` nem jelenít meg feliratot. > [accordion] Keretek QR-kód-típusonként > > | Típus | Feliratos keretek | Felirat nélküli keretek | > | - | - | - | > | App Link | `app-3` | `app-1`, `app-2` | > | vCard | `contact-1`, `contact-5` | `contact-2`, `contact-3`, `contact-4` | > | E-mail | `email-1` | `email-2`, `email-3`, `email-4`, `email-5` | > | Visszajelzés | — | `feedback-1`, `feedback-2`, `feedback-3`, `feedback-4`, `feedback-5` | > | Image | — | `image-1`, `image-2`, `image-3`, `image-4`, `image-5`, `image-6` | > | Helyszín | `location-3` | `location-1`, `location-2`, `location-4`, `location-5`, `location-6` | > | Multi-Link | `multilink-3` | `multilink-1`, `multilink-2` | > | Fizetés | — | `payment-1`, `payment-2`, `payment-3`, `payment-4`, `payment-5` | > | PDF | `pdf-1` | `pdf-2`, `pdf-3`, `pdf-4` | > | SMS | `sms-3`, `sms-5`, `sms-7` | `sms-1`, `sms-2`, `sms-4`, `sms-6` | > | Social Media | `social-3` | `social-1`, `social-2`, `social-4` | > | Video | `video-1`, `video-3` | `video-2`, `video-4`, `video-5`, `video-6` | > | Website | `website-1` | `website-2`, `website-3`, `website-4`, `website-5` | > | WhatsApp | `whatsapp-2` | `whatsapp-1`, `whatsapp-3`, `whatsapp-4` | > | WiFi | — | `wifi-1`, `wifi-2`, `wifi-3`, `wifi-4` | > > Bármely keret bármely QR-kód-típussal működik. A csoportosítás az irányítópultét követi. A felirat nélküli kereteknek az irányítópulton nincs cselekvésre ösztönző mezőjük, és rájuk nem vonatkozik az a szabály, hogy a `textColor` értékének el kell térnie a `color` értékétől. ## Logók A `logoOptions` objektum logót helyez a QR-kód közepére. A `type` mezővel választhatja ki a logó fajtáját. ### Javasolt logó Állítsa a `type` értékét `suggested` értékre, és válasszon egy `id` értéket a katalógusból. Logó nélküli kódhoz használja a `logo-none` értéket. ```json theme={null} { "logoOptions": { "type": "suggested", "id": "logo-instagram", "scalePercent": 25 } } ``` > [accordion] Az összes javasolt logó azonosítója > > `logo-none`, `logo-website-3`, `logo-website-4`, `logo-link`, `logo-pdf-1`, `logo-pdf-2`, `logo-pdf-3`, `logo-picture-1`, `logo-picture-2`, `logo-picture-3`, `logo-picture-5`, `logo-picture-7`, `logo-picture-8`, `logo-video-1`, `logo-video-5`, `logo-whatsapp-1`, `logo-whatsapp-2`, `logo-whatsapp`, `logo-wifi-1`, `logo-wifi-2`, `logo-wifi-3`, `logo-wifi`, `logo-airbnb`, `logo-apple`, `logo-binance`, `logo-bitcoin`, `logo-bolt-food`, `logo-booking`, `logo-facebook`, `logo-glovo`, `logo-google`, `logo-google-maps`, `logo-google-play`, `logo-instagram`, `logo-linkedin`, `logo-location`, `logo-mail`, `logo-paypal`, `logo-stripe`, `logo-venmo`, `logo-cashapp`, `logo-braintree`, `logo-square`, `logo-verifone`, `logo-google-pay`, `logo-apple-pay`, `logo-klarna`, `logo-ayden`, `logo-giropay`, `logo-cartes-bancaires`, `logo-restaurant`, `logo-scan-me`, `logo-tripadvisor`, `logo-trustpilot`, `logo-uber-eats`, `logo-youtube`, `logo-spotify`, `logo-spotify-black` ### Saját logó **1. Töltse fel a képet** Regisztrálja a [Fájlok](https://docs.getqr.com/hu/api/endpoints/files.md) végponttal, `"target": "logo"` értékkel, majd töltse fel a fájlt a visszakapott `uploadUrl` címre. **2. Hivatkozzon a fájlra** Állítsa a `type` értékét `uploaded` értékre, a `fileId` mezőt pedig a visszakapott `fileId` értékre. A `fileId` kötelező, és a Fájlok végpont által visszaadott azonosítónak kell lennie. ```json theme={null} { "logoOptions": { "type": "uploaded", "fileId": "file_7bQ2xR9mKp", "scalePercent": 35 } } ``` Az ismeretlen fájlt, a befejezetlen feltöltést vagy a más célhoz feltöltött fájlt a rendszer elutasítja. ### Logóméret A `scalePercent` a logó méretét állítja be a QR-kód százalékában. Az érték egy 15 és 45 közötti egész szám. Az alapértelmezés 25. Más értékek, köztük az olyan arányok, mint a `0.25`, `422` hibát kapnak. ## A dizájn frissítése * **Részleges frissítés.** A [QR-kód frissítése](https://docs.getqr.com/hu/api/endpoints/qr-codes.md#qr-kód-frissítése) végponton a `styles`, `frameOptions` és `logoOptions` objektum a tárolt dizájnba olvad. Egy részleges objektum csak azt módosítja, amit megnevez. * **A logó cseréje.** Másik logó választásakor az a tárolt logó helyére kerül, de a `scalePercent` értéke megmarad. * **Sablonok.** Ha létrehozáskor `templateId` értéket ad meg, az elküldött mezők a sablon dizájnjára olvadnak. Lásd: [Sablonok](https://docs.getqr.com/hu/api/endpoints/templates.md). * **Branded és AI dizájnok.** A `branded` vagy `ai` `designKind` értékű QR-kód az irányítópulton készült. Az API nem tudja szerkeszteni a képét, de megtartja, amikor más mezőket módosít. * **A dizájn kiolvasása.** A válaszok a tárolt dizájnt a `design` alatt adják vissza, a kérésmezőkkel azonos felépítésben, így vissza is küldheti. ## Gyakori problémák > [accordion] 422 "Error correction is always Q and is not an input" > > Távolítsa el a `styles.qrOptions` mezőt a kérésből. > [accordion] 422 "Frame caption is at most 12 characters" > > Rövidítse a `frameOptions.text` értékét legfeljebb 12 karakterre. > [accordion] 422 "Frame caption color must differ from the frame color" > > A `textColor` és a `color` azonos egy feliratos kereten. Válasszon kontrasztos `textColor` értéket. > [accordion] 422 "Logo scale is a whole number from 15 to 45" > > A `scalePercent` értékét egész százalékként küldje, például `25`, ne `0.25`. > [accordion] A sarkok színe nem változik > > A sarkok mindig a `dotsOptions.color` színt használják. A `cornersSquareOptions.color` és a `cornersDotOptions.color` hatástalan. ## Következő lépések > [card] [QR-kódok](https://docs.getqr.com/hu/api/endpoints/qr-codes.md) > [card] [Sablonok](https://docs.getqr.com/hu/api/endpoints/templates.md) > [card] [Fájlok](https://docs.getqr.com/hu/api/endpoints/files.md) > [card] [A tervezés áttekintése](https://docs.getqr.com/hu/design/overview.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.