ZPL-Vorschau-API
Eine HTTP-Anfrage macht aus ZPL ein Etikettenbild. Kein Drucker dazwischen, kein Treiber zu installieren, kein Konto zum Ausprobieren — und wenn der Renderer etwas überspringen muss, sagt er das in einem Antwort-Header, statt stillschweigend ein falsches Etikett zu zeichnen.
Die Anfrage
Senden Sie das ZPL als rohen Anfragekörper. Der Pfad trägt Druckdichte und Etikettengröße, sodass derselbe Code in der Auflösung geprüft werden kann, mit der der Zieldrucker tatsächlich läuft.
curl -X POST "https://labelixa.com/v1/printers/8dpmm/labels/4x6/0/" \
-H "Content-Type: text/plain" \
--data-binary $'^XA\n^FO50,50^A0N,40,40^FDLabelixa^FS\n^FO50,120^BY2^BCN,80,Y,N,N^FD1234567890^FS\n^XZ' \
-o label.png -D -
Was zurückkommt
Der Körper ist das Bild. Alles, was der Renderer beim Zeichnen bemerkt hat, steht in den Headern — genau das macht den Aufruf skriptfähig: Ein CI-Schritt kann bei einer Warnung abbrechen, ohne das Bild zu analysieren.
Antwort-Header
| Header | Was er aussagt |
|---|
Content-Type | Standardmäßig image/png; für PDF Accept: application/pdf senden. |
X-Warnings | Nur vorhanden, wenn der Renderer etwas übersprungen oder nicht vollständig gezeichnet hat — ein unbekannter Befehl, ein Feld außerhalb des Etiketts. |
X-Total-Count | Wie viele Etiketten der eingereichte Code erzeugt; ein Index wählt eines davon aus. |
X-Plan | Der Tarif, dem die Anfrage angerechnet wurde — bei einem anonymen Aufruf free. |
X-RateLimit-Remaining | Verbleibende Renderings im aktuellen Zeitfenster. |
Kontingente
Ein anonymer Aufruf wird dem Tarif free angerechnet und pro IP begrenzt. Ein API-Schlüssel verschiebt den Aufruf auf das Kontingent des Kontos.
| Tarif | Anfragen pro Sekunde | Etiketten pro Monat |
|---|
| free | 3 | 5.000 |
| starter | 5 | 25.000 |
| pro | 10 | 100.000 |
| business | 20 | 500.000 |
| enterprise | 20 | nach Vereinbarung |
Die anderen Etikettensprachen
ZPL ist nicht die einzige Eingabe. EPL, TSPL und CPCL haben eigene Render- und Diagnose-Endpunkte nach derselben Idee: Code hinein, Bild heraus, Befunde in einer strukturierten Antwort.
| Sprache | Endpunkt |
|---|
| ZPL | /v1/printers/{dpmm}dpmm/labels/{width}x{height}/{index}/ |
| EPL | /v1/epl/render |
| TSPL | /v1/tspl/render |
| CPCL | /v1/cpcl/render |
Eine Vorschau ist keine Druckgarantie
Ein Renderer zeichnet am Bildschirm, was der Code sagt. Ein Drucker fügt seine Firmware, residenten Schriften, Medien und Kalibrierung hinzu. Nutzen Sie die Vorschau für Fehler IM CODE — ein Feld außerhalb des Etiketts, ein Barcode, der seine Daten nicht kodieren kann, ein Befehl, den die Firmware ignoriert — und behalten Sie den Testdruck für die Fehler in der Hardware. Kein Online-Renderer, dieser eingeschlossen, kann Pixelgleichheit mit einem physischen Etikett versprechen.
Wie es weitergeht
Browser-Vorschau öffnen → API-Referenz lesen → KI-Assistenten verbinden (MCP) →
Verwandte Seiten
Häufig gestellte Fragen
Brauche ich ein Konto oder einen API-Schlüssel?
Nein. Anonyme Aufrufe funktionieren und sind pro IP begrenzt. Ein API-Schlüssel verschiebt den Aufruf auf das Kontingent eines Kontos, hebt die Grenzen an und macht die Nutzung zurechenbar.
Bekomme ich statt PNG auch PDF?
Ja — senden Sie Accept: application/pdf. Ansonsten dieselbe Anfrage, derselbe Pfad.
Was passiert bei nicht unterstütztem ZPL?
Das Etikett wird trotzdem gezeichnet, und die Antwort trägt einen X-Warnings-Header, der das Übersprungene benennt. Wenn Sie die Befunde als JSON wollen — mit Code, Schweregrad und Position —, senden Sie denselben Code an den Diagnose-Endpunkt.
Ist die gerenderte Vorschau dasselbe wie das gedruckte Etikett?
Nein, und kein Renderer kann das ehrlich behaupten. Die Vorschau zeigt, was der Code zeichnet; der Drucker fügt Firmware, Schriften, Medien und Kalibrierung hinzu. Sie findet Code-Fehler, keine Hardware-Fehler.
