Termal etiket API'si: ZPL, EPL, TSPL ve CPCL

Labelixa termal etiket kodunu dört yazıcı dilinde tek REST API üzerinden render eder ve denetler: ZPL'i derinlemesine, EPL, TSPL ve CPCL'in ise çekirdek komut kümesini. Her dilin PNG döndüren bir render ucu ve bulguları JSON olarak döndüren bir denetim ucu vardır. Yazıcı ya da sürücü gerekmez.

Diller ve uçlar

Tablo bugün canlı olanı gösterir. Birincil dil ZPL'dir. EPL, TSPL ve CPCL'de motor her dilin komut referansında listelenen komutları uygular; kapsam sütunu bunu eşitlik ima etmeden söyler.

Dosyanın hangi dilde olduğundan emin değil misiniz?

Kodu /v1/language-detect ucuna gönderin. Dili ve yazılı kurallardan çıkan yüksek, orta ya da düşük güven kademesini döndürür. Bir dil modeli değildir ve kodu saklamaz.

İstek

TSPL etiketi ZPL ile aynı yoldan render edilir: ham etiket kodu istek gövdesidir.

curl -X POST "https://labelixa.com/v1/tspl/render" \
  --data-binary $'SIZE 50 mm,30 mm\nGAP 2 mm,0 mm\nCLS\nTEXT 20,20,"3",0,1,1,"Labelixa"\nBARCODE 20,70,"128",60,1,0,2,2,"1234567890"\nPRINT 1' \
  -o label.png -D -

Dönen şey

Etiketin PNG görüntüsü döner. X-Warnings-Count motorun atladığı ya da tam çizemediği komut sayısını, X-Label-Count kodun kaç etiket ürettiğini söyler; ?index= birini seçer. Denetim ucu aynı bulguları JSON olarak döndürür.

Kotalar

Bugün ZPL render'ı aşağıdaki plan kotasından düşer. EPL, TSPL ve CPCL render ve denetimi, ZPL denetim ucu ve dil tespiti yalnız saniyelik istek sınırına tabidir; aylık etiket kotasını kullanmaz.

Bir yapay zekâ asistanından (MCP)

Aynı motorlar MCP araçları olarak da sunulur; asistan az önce yazdığı etiket kodunu render edip denetleyebilir:

• zpl_preview
• zpl_validate
• epl_preview
• epl_validate
• tspl_preview
• tspl_validate
• cpcl_preview
• cpcl_validate
• language_detect

Önizleme baskı garantisi değildir

Önizleme, motorun yazıcı kılavuzunu okuyuşudur; yazıcının kendisi değildir. EPL, TSPL ve CPCL önizlemeleri kılavuzları izler ve yalnız birkaç fiziksel yazıcıda denendi; yerleşik bitmap fontlar yaklaşık çizilir, uygulanan kümenin dışındaki komutlar çizilmek yerine uyarı olarak döner. ZPL kapsamı daha geniştir ama Zebra'nın tescilli fontları orada da ikameyle çizilir. Bir yerleşimi üretimde kullanmadan önce hedef yazıcıda bir test etiketi basın.

Buradan sonrası

Tarayıcıdaki önizlemeyi aç → API referansını oku → Yapay zekâ asistanını bağla (MCP) →

İlgili sayfalar

• ZPL Önizleme API'si
• Yapay Zekâ ile ZPL Render
• Labelixa nedir, ne yapar →

Sık sorulan sorular