Lógó sa Chód QR

Is féidir le cód lógó roghnach a bheith aige ina lár – do bhranda féin in ionad gnáthphatrún QR. Leabaítear an lógó mar phicsil iarbhír sna híoslódálacha SVG agus PNG; ní bhíonn sé i gcomhaid PDF ná EPS choíche.

Note

Ardaíonn lógó ceartúchán earráidí an chóid go leibhéal H, ionas go mbeidh an patrún inscannta fós fiú má tá an íomhá clúdaithe go páirteach. Tá míniú ar cad a chiallaíonn sé seo do chóid atá clóite cheana féin níos faide síos sa rannán Priontáil.

Sa Deais

Oscail leathanach mionsonraí cóid. In aice leis an réamhamharc QR agus na cnaipí íoslódála, tá an cárta Lógó sa Chód QR.

1. Cliceáil ar Roghnaigh Lógó agus roghnaigh comhad PNG, JPEG, nó WebP (uasmhéid 1 MB – diúltófar do bhformáidí níos mó nó do bhformáidí eile, lena n-áirítear SVG, sula n-uaslódálfar iad).
2. Taispeánfar réamhamharc ar an gcomhad roghnaithe in éineacht le fógra:
   • Níl aon lógó ann fós – athraíonn cur leis an lógó patrún poncanna an chóid. Deimhnigh leis an ticbhosca, ansin cliceáil ar Uaslódáil Lógó.
   • Tá lógó socraithe cheana féin – ní dhéanann athsholáthar ach an íomhá sa lár a mhalartú, fanann an patrún mar an gcéanna. Cliceáil ar Athsholáthair Lógó; ní gá deimhniú a dhéanamh.
3. Chun é a bhaint, cliceáil ar Bain Lógó, deimhnigh an ticbhosca rabhaidh (athraíonn baint an lógó an patrún freisin) agus deimhnigh an bhaint an dara huair.

Caution

Ní féidir ach le ról scríofa lógó a uaslódáil, a athsholáthar nó a bhaint. Feiceann an ról viewer an stádas reatha agus, chomh luath agus a bhíonn lógó socraithe, an fógra faoi bhformáidí priontála – ach ní féidir leis aon cheann den trí ghníomh a dhéanamh.

Trí API

Lógó a uaslódáil nó a athsholáthar

POST /v1/codes/{id}/logo – Iarratas ilpháirteach, réimse file.

cURL

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

Freagra (HTTP 201): an cód nuashonraithe, le logo_file_id socraithe.

Seiceáiltear an comhad bunaithe ar a chuid Magic Bytes, ní bunaithe ar an iarmhír nó ar an Content-Type. Déantar é a normalú go PNG trédhearcach le 512 × 512 px (coinnítear an cóimheas gné). Déantar lógó reatha a athsholáthar – ní bhíonn ach lógó amháin ann in aghaidh an chóid i gcónaí.

Bain Lógó

DELETE /v1/codes/{id}/logo – gan chorp (body).

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

Freagra (HTTP 200): an cód nuashonraithe, logo_file_id socraithe ar ais go null. Idéampótach – filleann glao gan lógó reatha 200 fós agus ní athraíonn sé aon rud.

Earráidí

Stádas	Cathain
403	Is é viewer ról an eochair API
404	Níor aimsíodh an cód sa spás oibre
413	Tá an comhad níos mó ná 1 MB
422	Tá an réimse file ar iarraidh, nó formáid seachas PNG/JPEG/WebP (lena n-áirítear SVG)

Cad a athraíonn ar an gcód

Leabaíonn qr.svg agus qr.png picsil iarbhír an lógó sa lár, scálaithe go dtí sciar seasta de limistéar an chóid. Ardaíonn an dá cheann an ceartúchán earráidí go H chuige sin, ionas go mbeidh an cód inscannta i gcónaí. Ní dhéanann lógó difear do qr.pdf ná do qr.eps – ní leabaíonn siad ceann choíche agus coinníonn siad an patrún a bheadh acu gan lógó.

Tip

Athraíonn cur leis an lógó, nuair nach raibh aon cheann socraithe roimhe seo, nó baint iomlán an lógó patrún poncanna an chóid (ceartúchán earráidí M ↔ H). Ar an láimh eile, ní athraíonn athsholáthar lógó reatha le híomhá eile an patrún – fanann an ceartúchán earráidí ag H, ní athraíonn ach na picsil leabaithe, fanann an mhaitrís mar an gcéanna.

Taisce

Nuair a bhíonn lógó socraithe, seachadtar qr.svg/qr.png le Cache-Control: public, max-age=300 (5 nóiméad) in ionad an ghnáthluacha public, max-age=86400, immutable (24 uair an chloig). Mar sin, glacfaidh URL íomhá atá leabaithe in áit eile – ar leathanach, i ríomhphost, i ndoiciméad – le hathrú lógó laistigh de suas le 5 nóiméad. D’fhéadfadh sé go dtógfadh cóip a taisceadh sula raibh lógó ag cóid riamh suas le 24 uair an chloig iomlán, toisc gur taisceadh í faoin saolré níos faide nach féidir a athrú.

Priontáil

• Leanann cód atá clóite cheana féin de bheith ag feidhmiú, is cuma an gcuirtear lógó leis, an n-athsholáthraítear é nó an mbaintear é – ní bhíonn an sprioc chódaithe ag brath ar an lógó choíche.
• Athraíonn cur leis nó baint lógó an patrún poncanna. Más ceart don lógó féin a bheith le feiceáil ar an ábhar clóite, athphriontáil leis an gcomhad reatha qr.svg nó qr.png – ná measc comhaid chlóite sheana agus nua choíche.
• Ní athraíonn athsholáthar lógó an patrún; ní bhíonn i gceist le hathphriontáil ansin ach ceist faoin íomhá nua atá ag teastáil, ní faoin inscanntacht.
• Ní bhíonn lógó i gcomhaid qr.pdf ná qr.eps choíche. Le haghaidh teimpléid phriontála ar cheart dóibh an lógó a thaispeáint, íoslódáil qr.svg nó qr.png.
• Roimh rith priontála iomlán, déan scanadh tástála ar an bhfíor-ábhar i gcónaí, go háirithe tar éis athrú patrúin.

Ábhar Gaolmhar

• Formáidí Íoslódála
• Comhaid & Bileoga Sonraí