Testreszabás

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, a sablonoknál és a tömeges létrehozásnál. Az ismeretlen formákat, kereteket vagy logókat a rendszer 422 hibával elutasítja.

Példa dizájnobjektum

{
  "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:

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.

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.

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.

Á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, clipboardA card-hor nem jelenít meg feliratot.

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.

{ "logoOptions": { "type": "suggested", "id": "logo-instagram", "scalePercent": 25 } }

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ó

Töltse fel a képet

Regisztrálja a Fájlok végponttal, "target": "logo" értékkel, majd töltse fel a fájlt a visszakapott uploadUrl címre.

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.

{ "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 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.
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

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.

422 "Frame caption is at most 12 characters"

Rövidítse a frameOptions.text értékét legfeljebb 12 karakterre.

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.

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.

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.

API

Példa dizájnobjektum

Stílusok

Keretek

Logók

Javasolt logó

Saját logó

Logóméret

A dizájn frissítése

Gyakori problémák

Következő lépések

QR-kódok

Sablonok

Fájlok

A tervezés áttekintése

​Példa dizájnobjektum

​Stílusok

​Keretek

​Logók

​Javasolt logó

​Saját logó

​Logóméret

​A dizájn frissítése

​Gyakori problémák

​Következő lépések

QR-kódok

Sablonok

Fájlok

A tervezés áttekintése

Példa dizájnobjektum

Stílusok

Keretek

Logók

Javasolt logó

Saját logó

Logóméret

A dizájn frissítése

Gyakori problémák

Következő lépések