Personalizare

API-ul GetQR este în versiune beta și este disponibil pentru anumite spații de lucru. Detaliile se pot schimba înainte de lansarea generală.

Stilizați un cod QR cu obiectele opționale styles, frameOptions și logoOptions atunci când îl creați sau îl actualizați. Toate câmpurile sunt opționale, iar pentru tot ce omiteți se aplică valorile implicite. Aceleași trei obiecte funcționează pentru coduri QR, șabloane și creări în masă. Formele, cadrele sau logourile necunoscute sunt respinse cu 422.

Exemplu de obiect de design

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

Trimiteți-l împreună cu restul codului QR:

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

Stiluri

Obiectul styles stabilește formele și culorile modelului.

Câmp	Valori
`dotsOptions.type`	Forma punctelor corpului: `square`, `dots`, `rounded`, `classy`, `classy-rounded`, `extra-rounded`
`cornersSquareOptions.type`	Forma pătratului de colț (rama ochiului): `square`, `rounded`, `dot`, `classy-rounded`
`cornersDotOptions.type`	Forma punctului de colț (pupila ochiului): `square`, `dot`, `dots`, `rounded`, `classy`
`dotsOptions.color`	Culoarea primului plan. Implicit `#000000`.
`backgroundOptions.color`	Culoarea fundalului. Implicit `#ffffff`.
`cornersSquareOptions.color`, `cornersDotOptions.color`	Acceptate, dar fără efect: colțurile folosesc întotdeauna `dotsOptions.color`.

Culori. Doar valori hex: #RGB sau #RRGGBB.
Corecția erorilor. Întotdeauna Q și nu poate fi setată. Trimiterea styles.qrOptions primește 422.
Designuri Branded și AI. Nu pot fi setate prin API. Trimiterea styles.logoQrArt primește 422.
Conținut. styles.data este ignorat. Imaginea codifică întotdeauna conținutul codului QR.

Păstrați un contrast suficient între culoarea primului plan și cea a fundalului, cu un prim plan închis pe un fundal deschis. Codurile cu contrast scăzut pot să nu fie scanate. Consultați Culori.

Cadre

Obiectul frameOptions adaugă în jurul codului QR un cadru decorativ cu un îndemn la acțiune.

Câmp	Descriere
`id`	Obligatoriu când trimiteți `frameOptions`. Tipul cadrului, din listele de mai jos. `none` înseamnă fără cadru.
`text`	Eticheta îndemnului la acțiune, până la 12 caractere. Implicit `Scan me!`.
`color`	Culoarea cadrului, hex.
`textColor`	Culoarea etichetei, hex. Trebuie să difere de `color` când cadrul afișează o etichetă, cu excepția cazului în care perechea este una dintre presetările de culori integrate ale cadrului.
`borderColor`	Culoarea bordurii, hex.
`fingerPrintColor`	Culoarea de accent a pictogramei cadrului, hex.

Cadre generale

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 nu afișează nicio etichetă.

Cadre pe tipuri de coduri QR

Tip	Cadre cu etichetă	Cadre fără etichetă
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`

Orice cadru funcționează cu orice tip de cod QR. Gruparea corespunde celei din panou.

Cadrele fără etichetă nu au câmp pentru îndemnul la acțiune în panou, iar regula conform căreia textColor trebuie să difere de color nu li se aplică.

Logouri

Obiectul logoOptions plasează un logo în centrul codului QR. Setați type pentru a alege tipul de logo.

Logo sugerat

Setați type la suggested și alegeți un id din catalog. Folosiți logo-none pentru a nu avea logo.

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

Toate ID-urile de logouri sugerate

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

Logoul propriu

Încărcați imaginea

Înregistrați-o cu Fișiere folosind "target": "logo", apoi încărcați fișierul la uploadUrl returnat.

Referiți fișierul

Setați type la uploaded și fileId la fileId returnat. fileId este obligatoriu și trebuie să fie un ID returnat de endpointul Files.

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

Un fișier necunoscut, o încărcare nefinalizată sau un fișier încărcat pentru alt target sunt respinse.

Dimensiunea logoului

scalePercent stabilește dimensiunea logoului ca procent din codul QR. Acceptă un număr întreg de la 15 la 45. Valoarea implicită este 25. Alte valori, inclusiv rapoarte precum 0.25, primesc 422.

Actualizarea unui design

Actualizări parțiale. La Actualizarea unui cod QR, styles, frameOptions și logoOptions sunt combinate cu designul stocat. Un obiect parțial modifică doar ce menționează.
Schimbarea logoului. Alegerea altui logo îl înlocuiește pe cel stocat, dar păstrează scalePercent.
Șabloane. Cu templateId la creare, câmpurile pe care le trimiteți sunt aplicate peste designul șablonului. Consultați Șabloane.
Designuri Branded și AI. Un cod QR cu designKind branded sau ai a fost creat în panou. API-ul nu îi poate edita imaginea, dar o păstrează când modificați alte câmpuri.
Citirea unui design. Răspunsurile returnează designul stocat sub design, în aceeași formă ca și câmpurile cererii, astfel încât să îl puteți trimite înapoi.

Probleme frecvente

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

Eliminați styles.qrOptions din cerere.

422 "Frame caption is at most 12 characters"

Scurtați frameOptions.text la cel mult 12 caractere.

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

textColor și color sunt identice pe un cadru care afișează o etichetă. Alegeți un textColor contrastant.

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

Trimiteți scalePercent ca procent întreg, de exemplu 25, nu 0.25.

Culoarea colțurilor nu se schimbă

Colțurile folosesc întotdeauna dotsOptions.color. cornersSquareOptions.color și cornersDotOptions.color nu au efect.

API

Exemplu de obiect de design

Stiluri

Cadre

Logouri

Logo sugerat

Logoul propriu

Dimensiunea logoului

Actualizarea unui design

Probleme frecvente

Ce urmează

Coduri QR

Șabloane

Fișiere

Prezentare generală a designului

​Exemplu de obiect de design

​Stiluri

​Cadre

​Logouri

​Logo sugerat

​Logoul propriu

​Dimensiunea logoului

​Actualizarea unui design

​Probleme frecvente

​Ce urmează

Coduri QR

Șabloane

Fișiere

Prezentare generală a designului

Exemplu de obiect de design

Stiluri

Cadre

Logouri

Logo sugerat

Logoul propriu

Dimensiunea logoului

Actualizarea unui design

Probleme frecvente

Ce urmează