Skip to content
qr3.app Docs

Лого в QR кода

Един код може да съдържа незадължително лого в центъра си – собствената марка вместо чист QR шаблон. Логото се вгражда като реални пиксели във всички четири изтеглени файла: SVG, PNG, PDF и EPS.

В Dashboard

Отворете страницата с подробности за даден код. До визуализацията на QR кода и бутоните за изтегляне се намира картата Лого в QR кода.

  1. Кликнете върху Избор на лого и изберете PNG, JPEG или WebP файл (максимум 1 MB – по-големи или други формати, включително SVG, се отхвърлят още преди качването).
  2. Появява се визуализация на избрания файл заедно със съобщение:
    • Все още няма лого – добавянето променя точковия шаблон на кода. Поставете отметка за потвърждение, след което кликнете върху Качване на лого.
    • Вече има зададено лого – замяната сменя само изображението в центъра, шаблонът остава същият. Кликнете върху Замяна на лого; не е необходимо потвърждение.
  3. За премахване кликнете върху Премахване на лого, потвърдете предупредителната отметка (премахването също променя шаблона) и потвърдете премахването втори път.

Чрез API

Качване или замяна на лого

POST /v1/codes/{id}/logo – Multipart заявка, поле file.

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

Отговор (HTTP 201): актуализираният код, със зададено logo_file_id.

Файлът се проверява въз основа на неговите магически байтове (magic bytes), а не по разширението или Content-Type. Той се нормализира до прозрачен PNG файл с размери 512 × 512 px (съотношението на страните се запазва). Съществуващото лого се заменя – за всеки код винаги има само едно лого.

Премахване на лого

DELETE /v1/codes/{id}/logo – без тяло (body).

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

Отговор (HTTP 200): актуализираният код, logo_file_id е върнат на null. Идемпотентно – извикване без съществуващо лого продължава да връща 200 и не променя нищо.

Грешки

СтатусКога
403Ролята на API ключа е viewer
404Кодът не е намерен в работното пространство (Workspace)
413Файлът е по-голям от 1 MB
422Полето file липсва или форматът е различен от PNG/JPEG/WebP (включително SVG)

Какво се променя в кода

И четирите формата – qr.svg, qr.png, qr.pdf и qr.eps – вграждат реалните пиксели на логото центрирано, мащабирано до фиксирана част от площта на кода. И четирите формата повишават корекцията на грешки до H, за да остане кодът сканируем.

Кеш

При зададено лого и четирите формата – qr.svg, qr.png, qr.pdf и qr.eps – се доставят с Cache-Control: public, max-age=300 (5 минути) вместо обичайните public, max-age=86400, immutable (24 часа). Така вграден на друго място URL адрес на изображение – на страница, в имейл, в документ – отразява промяната на логото в рамките на до 5 минути. Копие, което е било кеширано преди кодът изобщо да е имал лого, може да изисква до пълни 24 часа, тъй като е било кеширано с по-дългия, непроменим жизнен цикъл.

Печат

  • Вече отпечатан код продължава да работи, независимо дали се добавя, заменя или премахва лого – кодираната цел никога не зависи от логото.
  • Добавянето или премахването на лого променя точковия шаблон. Ако самото лого трябва да се появи върху печатния материал, отпечатайте отново с един от четирите актуални формата (qr.svg, qr.png, qr.pdf или qr.eps) – като никога не смесвате стари и нови файлове за печат.
  • Замяната на лого не променя шаблона; повторният печат в този случай е само въпрос на желаното ново изображение, а не на сканируемостта.
  • Всичките четири формата вече съдържат логото по еднакъв начин – кой формат е подходящ за собствения шаблон за печат, се решава единствено от програмата за оформление (векторен за PDF/EPS, растерен за PNG, SVG за двете).
  • Преди пълен тираж за печат винаги правете пробно сканиране върху реалния материал, особено след промяна на шаблона, и никога не смесвайте файлове от различни версии.

Свързани теми