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 вграждат реалните пиксели на логото центрирано, мащабирано до фиксирана част от площта на кода. И двата формата повишават корекцията на грешки до H, за да остане кодът сканируем. qr.pdf и qr.eps не се влияят от логото – те никога не вграждат такова и запазват шаблона, който биха имали и без лого.

Кеш

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

Печат

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

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