Skip to content
qr3.app Docs

Logo fil-kodiċi QR

Kodiċi jista’ jkollu logo mhux obbligatorju fin-nofs tiegħu – il-marka tiegħek stess minflok sempliċi mudell QR. Il-logo jiġi inkorporat bħala pixels attwali fit-tniżżil ta’ SVG u PNG; il-PDF u l-EPS qatt ma fihom.

Fid-Dashboard

Iftaħ il-paġna tad-dettalji ta’ kodiċi. Ħdejn il-preview tal-QR u l- buttuni tat-tniżżil hemm il-karta Logo fil-kodiċi QR.

  1. Ikklikkja fuq Agħżel il-logo u agħżel fajl PNG, JPEG jew WebP (massimu ta’ 1 MB – formati akbar jew oħrajn, inkluż SVG, jiġu rrifjutati qabel ma jittellgħu).
  2. Tidher preview tal-fajl magħżul flimkien ma’ nota:
    • Għadu m’hemm l-ebda logo – iż-żieda tbiddel il-mudell tal-punti tal- kodiċi. Ikkonferma l-kaxxa tal-għażla, imbagħad ikklikkja fuq Tella’ l-logo.
    • Diġà hemm logo stabbilit – is-sostituzzjoni tbiddel biss l-immaġni fin-nofs, il-mudell jibqa’ l-istess. Ikklikkja fuq Ibdel il-logo; m’hemmx bżonn ta’ konferma.
  3. Biex tneħħih, ikklikkja fuq Neħħi l-logo, ikkonferma l-kaxxa tal-għażla ta’ twissija (it-tneħħija tbiddel ukoll il-mudell) u kkonferma t-tneħħija għat-tieni darba.

Permezz tal-API

POST /v1/codes/{id}/logo – talba multipart, qasam file.

Terminal window
curl -X POST https://qr3.app/v1/codes/qr_a1b2c3d4/logo \
  -H "Authorization: Bearer qr3_sk_..." \
  -F "[email protected]"

Rispons (HTTP 201): il-kodiċi aġġornat, b’ logo_file_id stabbilit.

Il-fajl jiġi vverifikat abbażi tal-Magic Bytes tiegħu, mhux abbażi tal- estensjoni jew tal-Content-Type. Jiġi nnormalizzat għal PNG trasparenti ta’ 512 × 512 px (il-proporzjon tal-aspett jinżamm). Logo eżistenti jiġi sostitwit – dejjem hemm logo wieħed biss għal kull kodiċi.

DELETE /v1/codes/{id}/logo – mingħajr body.

Terminal window
curl -X DELETE https://qr3.app/v1/codes/qr_a1b2c3d4/logo \
  -H "Authorization: Bearer qr3_sk_..."

Rispons (HTTP 200): il-kodiċi aġġornat, b’ logo_file_id issettjat mill- ġdid għal null. Idempotenti – sejħa mingħajr logo eżistenti xorta tirritorna 200 u ma tbiddel xejn.

Żbalji

StatusMeta
403Ir-rwol tal-API key huwa viewer
404Il-kodiċi ma nstabx fil-workspace
413Il-fajl huwa akbar minn 1 MB
422Il-qasam file huwa nieqes, jew format differenti minn PNG/JPEG/WebP (inkluż SVG)

Xi jbiddel fil-kodiċi

qr.svg u qr.png jinkorporaw il-pixels attwali tal-logo fiċ-ċentru, skalat għal proporzjon fiss taż-żona tal-kodiċi. It-tnejn li huma jgħollu l- korrezzjoni tal-iżbalji għal H biex il-kodiċi jibqa’ jista’ jiġi skannjat. qr.pdf u qr.eps mhumiex affettwati minn logo – qatt ma jinkorporaw wieħed u jżommu l-mudell li jkollhom anke mingħajr logo.

Cache

B’logo stabbilit, qr.svg/qr.png jiġu pprovduti b’ Cache-Control: public, max-age=300 (5 minuti) minflok il-valur tas-soltu public, max-age=86400, immutable (24 siegħa). URL tal-immaġni inkorporata xi mkien ieħor – fuq paġna, f’email, f’dokument – għalhekk tapplika bidla fil- logo fi żmien sa 5 minuti. Kopja li ġiet issejvjata fil-cache qabel ma l- kodiċi qatt kellu logo tista’ tieħu sa 24 siegħa sħaħ, minħabba li ġiet issejvjata fil-cache taħt il-ħajja itwal u li ma tinbidilx.

Stampar

  • Kodiċi li diġà ġie stampat ikompli jaħdem, irrispettivament minn jekk logo jiġix miżjud, sostitwit jew imneħħi – id-destinazzjoni kkodifikata qatt ma tiddependi fuq il-logo.
  • Iż-żieda jew it-tneħħija ta’ logo tbiddel il-mudell tal-punti. Jekk il- logo nnifsu għandu jidher fuq il-materjal stampat, stampah mill-ġdid bl-użu tal-fajl attwali qr.svg oder qr.png – qatt m’għandek tħallat fajls tal- istampar qodma u ġodda.
  • Is-sostituzzjoni ta’ logo ma tbiddilx il-mudell; stampar mill-ġdid f’dan il-każ huwa biss kwistjoni tal-immaġni l-ġdida mixtieqa, mhux tal-kapaċità tal-iskannjar.
  • qr.pdf u qr.eps qatt ma fihom logo. Għal mudelli tal-istampar li għandhom juru l-logo, niżżel qr.svg jew qr.png.
  • Qabel ma tagħmel stampar sħiħ, dejjem agħmel skannjar tat-test fuq il- materjal reali, speċjalment wara bidla fil-mudell.

Relatati