Belgeler ve etiketler için QR kod PDF API'si
Belgeler ve etiketler içinde QR kodlarını vektör PDF çıktısı olarak render edin; URL, payload ve scan behavior sisteminizde kalır.
/api/v1/pdf/render URL, tanımlayıcı veya iş payload'u'u PDF belge veya etiket içinde QR kod olarak render ederken payload anlamını, destination ve tarama iş akışı kendi sisteminizde tutmak.
Bu API ne zaman kullanılır
- PDF belge veya etikette QR code gerekiyor.
- Payload veya URL sisteminiz tarafından üretiliyor ve doğrulanıyor.
- QR kodu metin, tablo, görsel veya label yerleşim ile aynı PDF içinde istiyorsunuz.
- Tekrarlanan QR yerleşimleri için Template Render kullanmak istiyorsunuz.
Neyin yerine geçmez
- gPdf'in short link, analytics, redirect veya landing sayfa servisi olmasını bekliyorsunuz.
- Payload semantics veya harici destination doğrulama'ı gPdf'ten bekliyorsunuz.
- Yazıcı/tarayıcı kabulü test yerine API claim kullanmak istiyorsunuz.
Hangi endpoint çağrılır
/api/v1/pdf/render
JSON Render bu iş akışı için varsayılan yoldur.
/api/v1/template-render
İş akışı ilgili API yoluna, template sözleşmesine veya capability sorgusuna ihtiyaç duyduğunda kullanın.
Minimum request
POST /api/v1/pdf/render - belge içinde QR code element.
{
"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
}
]
}
]
}
gPdf neyi üstlenir
- PDF içinde QR code barkod render işlemi.
- QR kodun belge veya etiket yerleşimina yerleştirilmesi.
- Tekrarlanan yerleşimler için Template Render.
- İndirme, print veya archive iş akışları için PDF çıktısı.
Sisteminiz neyi yönetir
- QR payload, URL destination, access rules ve iş semantiği.
- Tarama testi, print size, contrast ve malzeme seçimi.
- Landing sayfa, redirect, analytics ve sonraki sistem iş akışı.
Production kontrol listesi
- Payload ve destination'ı render öncesi doğrulayın.
- Üretim yazıcı, malzeme ve tarayıcı/telefon cihazları ile test edin.
- Kontrast, quiet zone ve modül boyutu'ı kontrol edin.
- Hassas URL'lerde erişim kontrolü'ü gPdf dışında tutun.
- Onaylı yerleşimler için Template Render kullanın.
İddia sınırları
- gPdf QR code'u PDF'e render eder; URL veya landing sayfa servisi değildir.
- Payload semantics ve destination availability çağıran sisteme aittir.
- Vektör render işlemi fiziksel scan doğrulama yerine geçmez.
QR kod sayfaları yine açık semantik ister
QR code PDF içinde küçük bir görsel gibi görünebilir, ancak payload dış bir davranışa bağlanır: URL, token, tanımlayıcı veya işlem durumu. gPdf bu değeri render eder; değerin geçerliliği ve hedefin davranışı sizin sisteminizdedir.
QR kodları üretimde gerçek materyal, kontrast ve hedef cihazlarla test edin. Vektör çıktı keskinlik sağlar, ancak tarama kabulü hâlâ fiziksel doğrulama gerektirir.
SSS
- gPdf QR kodları destekliyor mu?
- Evet. Public barkod schema QR code formatını destekler.
- gPdf QR linklerini yönetir mi?
- Hayır. Link, redirect, auth ve analytics sizin sisteminizdedir. gPdf yalnızca payload'u PDF'e render eder.
- QR kod Template Render ile kullanılabilir mi?
- Evet. Yayınlanmış template QR alanı içerebilir; çağıran sistem yalnızca variable data gönderir.
- Tarama testi gerekir mi?
- Evet. Üretim yazıcı, malzeme ve hedef cihazlarla doğrulama yapın.