ZPL Önizleme API'si
Tek bir HTTP isteği ZPL'i etiket görseline çevirir. Araya yazıcı girmez, sürücü kurulmaz, denemek için hesap gerekmez — ve render bir şeyi atlamak zorunda kaldığında yanlış etiketi sessizce çizmek yerine bunu bir yanıt başlığında söyler.
İstek
ZPL'i isteğin ham gövdesi olarak gönderin. Baskı yoğunluğu ve etiket ölçüsü yolda taşınır; böylece aynı kod, hedef yazıcının gerçekten çalıştığı çözünürlükte denenebilir.
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 -
Dönen şey
Gövde görselin kendisidir. Render'ın çizerken fark ettiği her şey başlıklardadır — çağrıyı betikten kullanılabilir yapan da budur: bir CI adımı resmi ayrıştırmadan uyarıda durabilir.
Yanıt başlıkları
| Başlık | Ne söyler |
|---|
Content-Type | Öntanımlı image/png; PDF için Accept: application/pdf gönderin. |
X-Warnings | Yalnız render bir şeyi atladığında ya da tam çizemediğinde gelir — tanımadığı bir komut, etiketin dışına taşan bir alan. |
X-Total-Count | Gönderilen kodun kaç etiket ürettiği; indeks bunlardan birini seçer. |
X-Plan | İsteğin hangi plana sayıldığı — anonim çağrıda free. |
X-RateLimit-Remaining | Bu pencerede kalan render hakkı. |
Kotalar
Anonim çağrı free plana sayılır ve IP başına sınırlanır. API anahtarı çağrıyı hesabın kendi kotasına taşır.
| Plan | Saniyede istek | Ayda etiket |
|---|
| free | 3 | 5.000 |
| starter | 5 | 25.000 |
| pro | 10 | 100.000 |
| business | 20 | 500.000 |
| enterprise | 20 | anlaşmayla |
Diğer etiket dilleri
Girdi yalnız ZPL değil. EPL, TSPL ve CPCL'in kendi render ve tanı uçları var; mantık aynı: kod girer, görsel çıkar, bulgular yapılandırılmış yanıtta gelir.
| Dil | Uç |
|---|
| ZPL | /v1/printers/{dpmm}dpmm/labels/{width}x{height}/{index}/ |
| EPL | /v1/epl/render |
| TSPL | /v1/tspl/render |
| CPCL | /v1/cpcl/render |
Önizleme baskı garantisi değildir
Render, kodun söylediğini ekranda çizer. Yazıcı buna kendi firmware'ini, gömülü yazı tiplerini, medyasını ve kalibrasyonunu ekler. Önizlemeyi KODDAKİ hataları yakalamak için kullanın — etiket dışına taşan alan, verisini kodlayamayan barkod, firmware'in yok sayacağı komut — donanımdakiler için deneme baskısı kalsın. Bu dâhil hiçbir çevrimiçi render, fiziksel etiketle piksel eşitliği vaat edemez.
Buradan sonrası
Tarayıcıdaki önizlemeyi aç → API referansını oku → Yapay zekâ asistanını bağla (MCP) →
İlgili sayfalar
Sık sorulan sorular
Hesap ya da API anahtarı gerekiyor mu?
Hayır. Anonim çağrılar çalışır ve IP başına hız sınırına tabidir. API anahtarı çağrıyı bir hesabın kotasına taşır, limitleri yükseltir ve kullanımın kime ait olduğunu belli eder.
PNG yerine PDF alabilir miyim?
Evet — Accept: application/pdf gönderin. İstek ve yol aynı kalır.
ZPL desteklenmeyen bir şey içerirse ne olur?
Etiket yine çizilir ve yanıt, neyin atlandığını söyleyen X-Warnings başlığını taşır. Bulguları JSON olarak — kod, önem derecesi ve konumla — istiyorsanız aynı kodu tanı ucuna gönderin.
Render edilen önizleme basılan etiketin aynısı mı?
Hayır ve hiçbir render bunu dürüstçe iddia edemez. Önizleme kodun çizdiğini gösterir; yazıcı firmware, yazı tipi, medya ve kalibrasyon ekler. Kod hatalarını yakalar, donanım hatalarını değil.
