Toplu Etiket Üretici

POST/api/v1/bulk-label-generator

Bir etiket şablonu ve bir tablodan yüzlerce basıma hazır ZPL etiketi üretin.

Kimlik Doğrulama

X-API-Key başlığında bir API anahtarı gerektirir.

Deneyin

POST/api/v1/bulk-label-generator

API anahtarı *

İstek gövdesi

Parametreler

templatestringzorunlu

Etiket şablonu JSON'u — yalnızca metin/barkod/kutu öğeleri; bu uç nokta resim/logo öğelerini desteklemez.

rowsstringzorunlu

Veri satırları; her nesnenin anahtarları şablondaki {{placeholder}} belirteçlerini doldurur.

quantityColumnstringopsiyonel

Satır başına kopya sayısını taşıyan satır anahtarı.

formatstringopsiyonel

Çıktı formatı. Varsayılan zpl (üretilen ZPL metnini içeren JSON). pdf ikili bir PDF döndürür.

zplpdf

İstek gövdesi

{
  "template": {
    "version": 1,
    "widthMm": 100,
    "heightMm": 50,
    "dpi": 203,
    "elements": [
      {
        "id": "el-1",
        "type": "text",
        "xMm": 5,
        "yMm": 5,
        "text": "{{name}}",
        "fontSizeMm": 6
      }
    ]
  },
  "rows": [
    {
      "name": "Jane Doe"
    },
    {
      "name": "John Smith"
    }
  ],
  "format": "zpl"
}

Yanıt kodları

200Başarılı.
400Geçersiz istek — gövdenizi veya parametrelerinizi kontrol edin.
401Eksik veya geçersiz API anahtarı.
403API anahtarı bu uç nokta için yetkili değil.
429Hız limiti aşıldı — kısa bir bekleme sonrası tekrar deneyin.

Dil

cURL

İstek

curl -X POST https://utilerio.com/api/v1/bulk-label-generator \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template":{"version":1,"widthMm":100,"heightMm":50,"dpi":203,"elements":[{"id":"el-1","type":"text","xMm":5,"yMm":5,"text":"{{name}}","fontSizeMm":6}]},"rows":[{"name":"Jane Doe"},{"name":"John Smith"}],"format":"zpl"}'

Yanıt

{ "zpl": "^XA...^XZ", "labelCount": 1, "skippedRows": 0, "warnings": [] }