Logo w kodzie QR
Kod może zawierać opcjonalne logo w swoim środku – własną markę zamiast samego wzoru QR. Logo jest osadzane jako rzeczywiste piksele we wszystkich czterech pobieranych plikach: SVG, PNG, PDF i EPS.
W Dashboardzie
Otwórz stronę szczegółów kodu. Obok podglądu kodu QR i przycisków pobierania znajduje się karta Logo w kodzie QR.
- Kliknij Wybierz logo i wybierz plik PNG, JPEG lub WebP (maksymalnie 1 MB – większe lub inne formaty, w tym SVG, są odrzucane jeszcze przed przesłaniem).
- Pojawi się podgląd wybranego pliku wraz z informacją:
- Brak logo – dodanie logo zmieni wzór punktowy kodu. Zaznacz pole wyboru, aby potwierdzić, a następnie kliknij Prześlij logo.
- Logo jest już ustawione – zastąpienie zmienia tylko obraz w środku, wzór pozostaje bez zmian. Kliknij Zastąp logo; potwierdzenie nie jest wymagane.
- Aby usunąć, kliknij Usuń logo, zaznacz ostrzegawcze pole wyboru (usunięcie również zmienia wzór) i potwierdź usunięcie po raz drugi.
Przez API
Przesyłanie lub zastępowanie logo
POST /v1/codes/{id}/logo – żądanie typu multipart, pole file.
curl -X POST https://qr3.app/v1/codes/qr_a1b2c3d4/logo \ -H "Authorization: Bearer qr3_sk_..." \Odpowiedź (HTTP 201): zaktualizowany kod z ustawionym logo_file_id.
Plik jest weryfikowany na podstawie jego sygnatury (magic bytes), a nie
rozszerzenia czy nagłówka Content-Type. Jest on normalizowany do
przezroczystego pliku PNG o wymiarach 512 × 512 px (z zachowaniem proporcji).
Istniejące logo zostanie zastąpione – dla każdego kodu może istnieć tylko jedno
logo.
Usuwanie logo
DELETE /v1/codes/{id}/logo – bez treści (body).
curl -X DELETE https://qr3.app/v1/codes/qr_a1b2c3d4/logo \ -H "Authorization: Bearer qr3_sk_..."Odpowiedź (HTTP 200): zaktualizowany kod, logo_file_id ponownie ustawione
na null. Operacja jest idempotentna – wywołanie bez istniejącego logo nadal
zwraca 200 i niczego nie zmienia.
Błędy
| Status | Kiedy |
|---|---|
| 403 | Rola klucza API to viewer |
| 404 | Nie znaleziono kodu w przestrzeni roboczej (Workspace) |
| 413 | Plik jest większy niż 1 MB |
| 422 | Brak pola file lub format inny niż PNG/JPEG/WebP (w tym SVG) |
Co zmienia się w kodzie
Wszystkie cztery formaty – qr.svg, qr.png, qr.pdf i qr.eps – osadzają rzeczywiste piksele logo na środku, przeskalowane do stałej części powierzchni kodu. W tym celu wszystkie cztery podnoszą korekcję błędów do poziomu H, aby kod pozostał skanowalny.
Pamięć podręczna (Cache)
Gdy logo jest ustawione, wszystkie cztery formaty – qr.svg, qr.png, qr.pdf i qr.eps – są dostarczane z nagłówkiem Cache-Control: public, max-age=300 (5 minut) zamiast standardowego public, max-age=86400, immutable (24 godziny). Adres URL obrazu osadzony w innym miejscu – na stronie, w wiadomości e-mail, w dokumencie – uwzględni zmianę logo w ciągu maksymalnie 5 minut. Kopia, która została zapisana w pamięci podręcznej zanim kod kiedykolwiek miał logo, może potrzebować do pełnych 24 godzin, ponieważ została zbuforowana z dłuższym, niezmiennym czasem wygasania.
Druk
- Już wydrukowany kod nadal działa, niezależnie od tego, czy logo zostanie dodane, zastąpione czy usunięte – zakodowany cel nigdy nie zależy od logo.
- Dodanie lub usunięcie logo zmienia wzór punktowy. Jeśli samo logo ma
pojawić się na materiale drukowanym, należy wydrukować kod ponownie przy
użyciu jednego z czterech aktualnych formatów (
qr.svg,qr.png,qr.pdflubqr.eps) – nigdy nie należy przy tym mieszać starych i nowych plików do druku. - Zastąpienie logo nie zmienia wzoru; ponowny druk jest wtedy jedynie kwestią pożądanego nowego obrazu, a nie skanowalności.
- Wszystkie cztery formaty zawierają teraz logo w ten sam sposób – o tym, który format nadaje się do własnego szablonu druku, decyduje wyłącznie program do składu (wektor dla PDF/EPS, raster dla PNG, SVG dla obu).
- Przed pełnym nakładem druku należy zawsze wykonać skan próbny na rzeczywistym materiale, szczególnie po zmianie wzoru, i nigdy nie mieszać plików z różnych wersji.