Tilpasning

GetQR API-et er i beta og er tilgjengelig for utvalgte arbeidsområder. Detaljer kan endres før den generelle lanseringen.

Gi en QR-kode stil med de valgfrie objektene styles, frameOptions og logoOptions når du oppretter eller oppdaterer den. Alle felt er valgfrie, og standardverdier brukes for alt du utelater. De samme tre objektene fungerer for QR-koder, maler og masseopprettelser. Ukjente former, rammer eller logoer avvises 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 av 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" }
  }'

Stiler

styles-objektet angir former og farger i mønsteret.

Felt	Verdier
`dotsOptions.type`	Formen på prikkene i mønsteret: `square`, `dots`, `rounded`, `classy`, `classy-rounded`, `extra-rounded`
`cornersSquareOptions.type`	Formen på hjørnefirkanten (øyets ramme): `square`, `rounded`, `dot`, `classy-rounded`
`cornersDotOptions.type`	Formen på hjørneprikken (øyeeplet): `square`, `dot`, `dots`, `rounded`, `classy`
`dotsOptions.color`	Forgrunnsfarge. Standard `#000000`.
`backgroundOptions.color`	Bakgrunnsfarge. Standard `#ffffff`.
`cornersSquareOptions.color`, `cornersDotOptions.color`	Godtas, men har ingen effekt: hjørnene bruker alltid `dotsOptions.color`.

Farger. Bare heksadesimale verdier: #RGB eller #RRGGBB.
Feilkorrigering. Alltid Q, og ikke noe du angir. Sender du styles.qrOptions, får du 422.
Branded design og AI design. Kan ikke angis via API-et. Sender du styles.logoQrArt, får du 422.
Innhold. styles.data ignoreres. Bildet koder alltid innholdet i QR-koden.

Sørg for god kontrast mellom forgrunns- og bakgrunnsfargen, med mørk forgrunn på lys bakgrunn. Koder med lav kontrast kan være vanskelige å skanne. Se Farger.

Rammer

frameOptions-objektet legger til en dekorativ ramme med en handlingsoppfordring rundt QR-koden.

Felt	Beskrivelse
`id`	Påkrevd når du sender `frameOptions`. Rammetypen, fra listene nedenfor. `none` betyr ingen ramme.
`text`	Etikett for handlingsoppfordringen, opptil 12 tegn. Standard `Scan me!`.
`color`	Rammefarge, heksadesimal.
`textColor`	Etikettfarge, heksadesimal. Må være ulik `color` når rammen viser en etikett, med mindre paret er en av rammens innebygde fargekombinasjoner.
`borderColor`	Kantfarge, heksadesimal.
`fingerPrintColor`	Aksentfarge for rammeikonet, heksadesimal.

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 etikett.

Rammer per QR-kodetype

Type	Rammer med etikett	Rammer uten etikett
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 fungerer med alle QR-kodetyper. Grupperingen følger dashbordet.

Rammer uten etikett har ikke noe felt for handlingsoppfordring i dashbordet, og regelen om at textColor må være ulik color, gjelder ikke for dem.

Logoer

logoOptions-objektet plasserer en logo midt i QR-koden. Angi type for å velge logotype.

Foreslått logo

Sett type til suggested og velg en id fra katalogen. Bruk logo-none for ingen logo.

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

Alle ID-er for foreslåtte 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

Din egen logo

Last opp bildet

Registrer det med Filer med "target": "logo", og last deretter opp filen til uploadUrl som returneres.

Henvis til filen

Sett type til uploaded og fileId til fileId som returneres. fileId er påkrevd og må være en ID som Filer-endepunktet har returnert.

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

En ukjent fil, en ufullført opplasting eller en fil lastet opp for et annet target avvises.

Logostørrelse

scalePercent angir logostørrelsen i prosent av QR-koden. Den tar et heltall fra 15 til 45. Standard er 25. Andre verdier, også forholdstall som 0.25, gir 422.

Oppdatere et design

Delvise oppdateringer. Med Oppdater en QR-kode flettes styles, frameOptions og logoOptions inn i det lagrede designet. Et delvis objekt endrer bare det det nevner.
Bytte logo. Velger du en annen logo, erstattes den lagrede, men scalePercent beholdes.
Maler. Med templateId ved oppretting flettes feltene du sender, oppå malens design. Se Maler.
Branded design og AI design. En QR-kode med designKind branded eller ai er laget i dashbordet. API-et kan ikke redigere bildet, men beholder det når du endrer andre felt.
Lese et design. Svar returnerer det lagrede designet under design, i samme form som feltene i forespørselen, så du kan sende det tilbake.

Vanlige problemer

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

Fjern styles.qrOptions fra forespørselen.

422 "Frame caption is at most 12 characters"

Kort ned frameOptions.text til 12 tegn eller færre.

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

textColor og color er like på en ramme som viser en etikett. Velg en textColor som gir kontrast.

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

Send scalePercent som en hel prosentverdi, for eksempel 25, ikke 0.25.

Hjørnefargen endres ikke

Hjørnene bruker alltid dotsOptions.color. cornersSquareOptions.color og cornersDotOptions.color har ingen effekt.

API

Eksempel på designobjekt

Stiler

Rammer

Logoer

Foreslått logo

Din egen logo

Logostørrelse

Oppdatere et design

Vanlige problemer

Neste steg

QR-koder

Maler

Filer

Designoversikt

​Eksempel på designobjekt

​Stiler

​Rammer

​Logoer

​Foreslått logo

​Din egen logo

​Logostørrelse

​Oppdatere et design

​Vanlige problemer

​Neste steg

QR-koder

Maler

Filer

Designoversikt

Eksempel på designobjekt

Stiler

Rammer

Logoer

Foreslått logo

Din egen logo

Logostørrelse

Oppdatere et design

Vanlige problemer

Neste steg