Tilpasning

GetQR API’et er i beta og er tilgængeligt for udvalgte arbejdsområder. Detaljer kan ændre sig før den generelle udgivelse.

Du styler en QR-kode med de valgfrie objekter styles, frameOptions og logoOptions, når du opretter eller opdaterer den. Alle felter er valgfri, og standardværdier gælder for alt, du udelader. De samme tre objekter virker på QR-koder, skabeloner og bulk-oprettelser. Ukendte former, rammer eller logoer afvises med 422.

Eksempel på designobjekt

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

Send det sammen med resten af QR-koden:

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" }
  }'

Stilarter

Objektet styles bestemmer mønstrets former og farver.

Felt	Værdier
`dotsOptions.type`	Formen på kroppens prikker: `square`, `dots`, `rounded`, `classy`, `classy-rounded`, `extra-rounded`
`cornersSquareOptions.type`	Formen på hjørnefirkanten (øjets ramme): `square`, `rounded`, `dot`, `classy-rounded`
`cornersDotOptions.type`	Formen på hjørneprikken (øjeæblet): `square`, `dot`, `dots`, `rounded`, `classy`
`dotsOptions.color`	Forgrundsfarve. Standard er `#000000`.
`backgroundOptions.color`	Baggrundsfarve. Standard er `#ffffff`.
`cornersSquareOptions.color`, `cornersDotOptions.color`	Accepteres, men har ingen effekt: Hjørner bruger altid `dotsOptions.color`.

Farver. Kun hex-værdier: #RGB eller #RRGGBB.
Fejlkorrektion. Altid Q, og den kan ikke angives. Sender du styles.qrOptions, får du 422.
Branded- og AI-designs. Kan ikke angives via API’et. Sender du styles.logoQrArt, får du 422.
Indhold. styles.data ignoreres. Billedet koder altid QR-kodens indhold.

Sørg for tilstrækkelig kontrast mellem forgrunds- og baggrundsfarven, med en mørk forgrund på en lys baggrund. Koder med lav kontrast kan muligvis ikke scannes. Se Farver.

Rammer

Objektet frameOptions tilføjer en dekorativ ramme med en handlingsopfordring omkring QR-koden.

Felt	Beskrivelse
`id`	Påkrævet, når du sender `frameOptions`. Rammetypen fra listerne nedenfor. `none` betyder ingen ramme.
`text`	Etiket med handlingsopfordringen, op til 12 tegn. Standard er `Scan me!`.
`color`	Rammens farve, hex.
`textColor`	Etikettens farve, hex. Skal være forskellig fra `color`, når rammen viser en etiket, medmindre parret er en af rammens indbyggede farveforvalg.
`borderColor`	Kantfarve, hex.
`fingerPrintColor`	Accentfarve på rammens ikon, hex.

Generelle rammer

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, clipboardcard-hor viser ingen etiket.

Rammer efter QR-kodetype

Type	Rammer med etiket	Rammer uden etiket
App Link	`app-3`	`app-1`, `app-2`
vCard	`contact-1`, `contact-5`	`contact-2`, `contact-3`, `contact-4`
Email	`email-1`	`email-2`, `email-3`, `email-4`, `email-5`
Feedback	—	`feedback-1`, `feedback-2`, `feedback-3`, `feedback-4`, `feedback-5`
Image	—	`image-1`, `image-2`, `image-3`, `image-4`, `image-5`, `image-6`
Location	`location-3`	`location-1`, `location-2`, `location-4`, `location-5`, `location-6`
Multi-Link	`multilink-3`	`multilink-1`, `multilink-2`
Payment	—	`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`

Alle rammer virker med alle QR-kodetyper. Grupperingen svarer til dashboardet.

Rammer uden etiket har intet felt til handlingsopfordring i dashboardet, og reglen om, at textColor skal være forskellig fra color, gælder ikke for dem.

Logoer

Objektet logoOptions placerer et logo i midten af QR-koden. Angiv type for at vælge slags logo.

Foreslået logo

Sæt type til suggested, og vælg et id fra kataloget. Brug logo-none for intet logo.

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

Alle id'er for foreslåede logoer

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

Dit eget logo

Upload billedet

Registrer det med Filer med "target": "logo", og upload derefter filen til den returnerede uploadUrl.

Henvis til filen

Sæt type til uploaded og fileId til den returnerede fileId. fileId er påkrævet og skal være et id, som endepunktet Filer har returneret.

{ "logoOptions": { "type": "uploaded", "fileId": "file_7bQ2xR9mKp", "scalePercent": 35 } }

En ukendt fil, en ufærdig upload eller en fil, der er uploadet til et andet target, afvises.

Logostørrelse

scalePercent angiver logoets størrelse som en procentdel af QR-koden. Det tager et heltal fra 15 til 45. Standard er 25. Andre værdier, herunder forhold som 0.25, giver 422.

Opdatering af et design

Delvise opdateringer. Ved Opdater en QR-kode flettes styles, frameOptions og logoOptions ind i det gemte design. Et delvist objekt ændrer kun det, det nævner.
Skift af logo. Vælger du et andet logo, erstattes det gemte, men dets scalePercent bevares.
Skabeloner. Med templateId ved oprettelse flettes de felter, du sender, oven på skabelonens design. Se Skabeloner.
Branded- og AI-designs. En QR-kode med designKind branded eller ai er lavet i dashboardet. API’et kan ikke redigere dens billede, men bevarer det, når du ændrer andre felter.
Læsning af et design. Svar returnerer det gemte design under design i samme form som felterne i forespørgslen, så du kan sende det tilbage.

Almindelige problemer

422 "Error correction is always Q and is not an input"

Fjern styles.qrOptions fra forespørgslen.

422 "Frame caption is at most 12 characters"

Forkort frameOptions.text til 12 tegn eller færre.

422 "Frame caption color must differ from the frame color"

textColor og color er ens på en ramme, der viser en etiket. Vælg en textColor, der står i kontrast.

422 "Logo scale is a whole number from 15 to 45"

Send scalePercent som en hel procentværdi, f.eks. 25, ikke 0.25.

Hjørnefarven ændrer sig ikke

Hjørner bruger altid dotsOptions.color. cornersSquareOptions.color og cornersDotOptions.color har ingen effekt.

API

Eksempel på designobjekt

Stilarter

Rammer

Logoer

Foreslået logo

Dit eget logo

Logostørrelse

Opdatering af et design

Almindelige problemer

Næste skridt

QR-koder

Skabeloner

Filer

Designoversigt

​Eksempel på designobjekt

​Stilarter

​Rammer

​Logoer

​Foreslået logo

​Dit eget logo

​Logostørrelse

​Opdatering af et design

​Almindelige problemer

​Næste skridt

QR-koder

Skabeloner

Filer

Designoversigt

Eksempel på designobjekt

Stilarter

Rammer

Logoer

Foreslået logo

Dit eget logo

Logostørrelse

Opdatering af et design

Almindelige problemer

Næste skridt