Ratgeber › Einen ZPL-Etiketten-Viewer in die eigene Seite einbetten

Einen ZPL-Etiketten-Viewer in die eigene Seite einbetten

Veröffentlicht: 2026-08-25

Wenn Ihre Dokumentation, Ihr Support-Portal oder ein internes Werkzeug ZPL-Code zeigt, können Sie daneben das gerenderte Etikett mit einem einzigen iframe zeigen. Keine JavaScript-Bibliothek, kein API-Schlüssel, kein serverseitiger Code:

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

Was nach dem # kommt

Das Fragment trägt ein base64-kodiertes JSON-Objekt mit dem Etikett:

const daten = {z: "^XA^FO50,50^A0N,40^FDHallo^FS^XZ",
               d: "8",   // dpmm: 6, 8, 12 oder 24
               w: "4",   // Breite in Zoll
               h: "6"};  // Höhe in Zoll
const hash = btoa(unescape(encodeURIComponent(JSON.stringify(daten))));
iframe.src = "https://labelixa.com/embed/viewer#" + hash;

Der einfachste Weg zu einem korrekten Wert: den ZPL-Viewer öffnen, das Etikett einfügen und "Link kopieren" nutzen — der Teil nach # ist genau dieses Format.

Warum das ZPL im Fragment reist

Der Teil nach # wird in keiner Request-URL gesendet; Ihr Etiketteninhalt landet weder in Proxy-Logs noch in CDN-Logs noch im Referer-Header. Die eingebettete Seite liest ihn im Browser und rendert über dieselbe API wie der Haupt-Viewer.

Ehrliche Grenzen

Das Embed nutzt das anonyme Rendering-Kontingent — ausreichend für Dokumentationsseiten und Support-Threads, aber nicht für stark besuchte Produktseiten dimensioniert; dort serverseitig über die API mit Schlüssel rendern und das Bild cachen. Das iframe passt sich der vorgegebenen Höhe an, und unter dem Etikett bleibt ein kleiner "Labelixa"-Link sichtbar: Dieser Link ist der Preis des kostenlosen Embeds.

Häufig gestellte Fragen

Brauche ich einen API-Schlüssel, um den Viewer einzubetten?

Nein. Das Embed läuft über das anonyme Rendering-Kontingent — genug für Dokumentations- und Support-Seiten. Stark besuchte Seiten sollten serverseitig über die API mit Schlüssel rendern und das Bild cachen.

Wird das ZPL in der iframe-URL an Ihre Server gesendet?

Das Etikett reist nach dem # (im URL-Fragment), das Browser nie als Teil einer Request-URL senden — es bleibt aus Proxy-Logs, CDN-Logs und Referer-Headern heraus. Das Rendering läuft über dieselbe API wie der Haupt-Viewer.

Kann ich den Labelixa-Link unter dem Etikett entfernen?

Nein — der sichtbare Link ist der Preis des kostenlosen Embeds. Für ein Bild ohne Branding über die API rendern und das PNG selbst ausliefern.