Kendi Sitenize ZPL Etiket Önizleyici Gömme

Yayın tarihi: 2026-08-25

Dokümantasyonunuz, destek portalınız ya da iç aracınız ZPL kodu gösteriyorsa, yanında render edilmiş etiketi tek iframe ile gösterebilirsiniz. JavaScript kütüphanesi yok, API anahtarı yok, sunucu tarafı kod yok:

<iframe
  src="https://labelixa.com/embed/viewer#KODLANMIS"
  style="width:100%;height:420px;border:0"></iframe>

# işaretinden sonra ne var

Parça (fragment), etiketi taşıyan base64 kodlu bir JSON nesnesidir:

const veri = {z: "^XA^FO50,50^A0N,40^FDMerhaba^FS^XZ",
              d: "8",   // dpmm: 6, 8, 12 ya da 24
              w: "4",   // genişlik (inç)
              h: "6"};  // yükseklik (inç)
const hash = btoa(unescape(encodeURIComponent(JSON.stringify(veri))));
iframe.src = "https://labelixa.com/embed/viewer#" + hash;

Doğru değeri almanın en kolay yolu: ZPL görüntüleyiciyi açın, etiketi yapıştırın ve "bağlantıyı kopyala" deyin — # sonrası tam olarak bu biçimdir.

ZPL neden fragment'te taşınıyor

# sonrası hiçbir isteğin URL'inde gönderilmez; etiket içeriğiniz vekil loglarına, CDN loglarına ya da Referer başlığına düşmez. Gömülü sayfa onu tarayıcıda okur ve ana görüntüleyiciyle aynı API üzerinden render eder.

Dürüst sınırlar

Gömme anonim render kotasını kullanır; dokümantasyon sayfaları ve destek konuları için yeterlidir ama yüksek trafikli ürün sayfaları için boyutlandırılmamıştır — orada API üzerinden anahtarla sunucu tarafında render edip görseli önbelleğe alın. iframe verdiğiniz yüksekliğe uyar; etiketin altında küçük bir "Labelixa" bağlantısı görünür kalır: ücretsiz gömmenin bedeli o bağlantıdır.

Sık sorulan sorular

Görüntüleyiciyi gömmek için API anahtarı gerekir mi?

Hayır. Gömme anonim render kotasıyla çalışır — dokümantasyon ve destek sayfalarına yeter. Yüksek trafikli sayfalar API üzerinden anahtarla sunucu tarafında render edip görseli önbelleğe almalı.

iframe URL'indeki ZPL sunucularınıza gönderiliyor mu?

Etiket # işaretinden sonra (URL fragment'inde) taşınır; tarayıcılar bu kısmı istek URL'inin parçası olarak asla göndermez — vekil loglarına, CDN loglarına ve Referer başlığına düşmez. Render, ana görüntüleyiciyle aynı API üzerinden olur.

Etiketin altındaki Labelixa bağlantısını kaldırabilir miyim?

Hayır — görünür bağlantı ücretsiz gömmenin bedelidir. Markasız görsel gerekiyorsa API üzerinden render edip PNG'yi kendiniz sunun.

İlgili yazılar

Kendi ZPL kodunuzu deneyin →