Kody kreskowe i retail
API kodów QR w PDF dla dokumentów i etykiet
Renderuj kody QR w PDF dla paragonów, biletów, etykiet, pakietów onboardingowych i procesów wyszukiwania dokumentów przy użyciu JSON Render albo szablonów.
GŁÓWNE API JSON Render
ENDPOINT
/api/v1/pdf/render SYSTEMY backend SaaS / backend ecommerce / backend ticketingowy / usługa automatyzacji dokumentów
Zadanie do wykonania
Umieszczaj kody QR w dokumentach PDF, etykietach, paragonach, biletach albo formularzach, aby użytkownicy mogli zeskanować link, identyfikator albo token wyszukiwania kontrolowany przez Twój system.
Kiedy użyć tej API
- Twój system ma URL, token, identyfikator zamówienia, identyfikator biletu albo wartość wyszukiwania do zakodowania.
- Potrzebujesz kodu QR narysowanego w PDF, a nie złożonego z zewnętrznej bitmapy.
- Potrzebujesz powtarzalnych układów opartych na QR przez Template Render.
- Chcesz jednej ścieżki API dla tekstu, layoutu, wyjścia PDF i renderowania kodu QR.
Czego nie zastępuje
- Potrzebujesz skracania URL-i, wystawiania tokenów dostępu albo tworzenia linków płatniczych przez gPdf.
- Potrzebujesz analityki skanowania albo logiki aplikacji mobilnej.
- Potrzebujesz kodów QR poza wyjściem PDF.
Który endpoint wywołać
/api/v1/pdf/render
JSON Render to domyślna ścieżka dla tego procesu.
/api/v1/template-render
Użyj, gdy proces wymaga powiązanej ścieżki API, kontraktu szablonu albo sprawdzenia capabilities.
Minimalny request
POST /api/v1/pdf/render - strona dokumentu z kodem QR do wyszukiwania.
{
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Scan to view this document online",
"style": { "font_size": 14, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "qrcode",
"content": "https://example.com/documents/DOC-2026-001",
"x": 20,
"y": 44,
"width": 32,
"height": 32
}
]
}
]
}
Co obsługuje gPdf
- Wektorowe renderowanie kodów QR wewnątrz wyjścia PDF.
- Tekst, layout, paragon, bilet, etykietę albo kontekst dokumentu wokół kodu QR.
- Wiązanie szablonu dla powtarzalnych procesów QR.
- Dostarczenie odpowiedzi PDF przez publiczne API renderowania.
Co kontroluje Twój system
- Zakodowany URL albo token, kontrolę dostępu, wygaśnięcie, przekierowania i miejsce docelowe na urządzeniu mobilnym.
- Testy skanowania, ścieżkę użytkownika i reguły zapobiegania nadużyciom.
- Każdą płatność, bilet, zwrot albo akcję na koncie uruchamianą po zeskanowaniu.
Checklist produkcyjny
- Utrzymuj zakodowane URL-e jako stabilne albo przekierowywalne przez cały cykl życia dokumentu.
- Przetestuj odległość skanowania, kontrast, rozmiar i materiał druku.
- Unikaj osadzania w kodzie QR surowych danych wrażliwych.
- Używaj request ID i loguj obiekt biznesowy powiązany z każdym wygenerowanym PDF.
- Przenieś stabilne układy QR do Template Render.
Granice deklaracji
- gPdf renderuje kody QR w PDF; nie hostuje ani nie zabezpiecza miejsca docelowego.
- Twój system odpowiada za wygaśnięcie tokenów, przekierowania, uprawnienia i doświadczenie skanowania.
- Kod QR sam w sobie nie jest systemem płatności ani ticketingu.
Strony z kodem QR nadal wymagają jasnej semantyki
Kod QR jest tylko widocznym nośnikiem. Proces produkcyjny zależy od miejsca docelowego albo tokenu, który za nim stoi. gPdf rysuje kod QR w PDF; Twój system odpowiada za to, co dzieje się po zeskanowaniu.
FAQ
- Czy gPdf generuje obrazy kodów QR?
- gPdf renderuje elementy kodów QR wewnątrz wyjścia PDF. Publiczna odpowiedź jest plikiem PDF, a nie samodzielną usługą obrazów.
- Czy kodów QR można używać w szablonach?
- Tak. Szablon może zawierać pola QR, a systemy wywołujące mogą wysyłać zmienne dane do zakodowania.
- Kto odpowiada za miejsce docelowe kodu QR?
- Twój system odpowiada za URL-e, tokeny, przekierowania, uprawnienia i zachowanie wygaśnięcia.
- Czy kod QR może zawierać dane wrażliwe?
- Może zakodować wszystko, co wyślesz, ale systemy produkcyjne zwykle powinny kodować token wyszukiwania albo URL zamiast surowych danych wrażliwych.