Etiket yazdırma API'si

• Hedef ZPL, TSPL, TPCL veya Epson konuşsa da tek bir istek biçimi.
• Etiketin kendisi de istemci olabilir: bir alan grubunu Bearer, Basic veya API anahtarı doğrulamasıyla kendi JSON uç noktanıza yöneltin.
• Webhook'lar iş olaylarını sizi yoklamaya zorlamadan sisteminize bildirir.
• Aynı işlemler MCP üzerinden de açıktır; bir yapay zekâ ajanı baskıyı aynı yüzeyden sürebilir.

• Fiziksel yazıcının yanında yine de bir LabelInn çalışma ortamı gerekir: yazıcının bağlı olduğu bilgisayar çevrimiçi olmalı ve o yazıcı için bulut baskısı açık olmalı. API işi yönlendirir; donanıma ağ yolu yaratmaz.
• API yazma (iş oluşturma) Pro (aylık $24.90) veya 14 günlük deneme gerektirir. Ücretsiz ve Starter anahtarları okuyabilir ve salt okunur sandbox kotasını kullanabilir.
• 201 işin kuyruğa alındığı anlamına gelir, basıldığı değil. İşi sorgulayın ya da sonucu öğrenmek için webhook'lara abone olun.
• Limitler etiket değil istek sayar: her çağrıda bir etiket gönderen bir döngü tasarlamadan önce aşağıdaki tabloya bakın.

1. LabelInn'de Ayarlar, API Anahtarları bölümünden bir anahtar oluşturun. sk_test_ anahtarları hiç basmayan ve kendi kotası olan bir sandbox'a karşı çalışır; sk_live_ anahtarları işleri fiziksel yazıcılara gönderir.
2. GET /v1/fleet/printers: is_online: true ve cloud_print_enabled: true olan bir yazıcı seçin. İkinci bayrağı müşteri masaüstü uygulamasında açar; API açamaz. Çevrimdışı yazıcıya giden iş kuyrukta bekler.
3. GET /v1/designs/{designId}/variables: tam alan adlarını ve hazır bir example_payload döndürür. Tasarımın tanımadığı anahtarlar sessizce yok sayılır; bu, bağlama hatasıyla aynı görünür.
4. payload_type: "template" ile POST /v1/print/jobs, sonra durum bitiş durumlarından biri olana kadar yaklaşık 2 saniyede bir GET /v1/print/jobs/{id}.

curl https://labelinn.com/v1/print/jobs \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: order-SO-10442-line-1:1" \
  -d '{
    "printer_id": "prt_abc123",
    "payload_type": "template",
    "design_id": "dsg_shipping",
    "data": { "order_id": "SO-10442", "customer": "Maya Brandt", "barcode": "TR123456789" },
    "copies": 2
  }'

HTTP/1.1 201 Created
{
  "success": true,
  "data": {
    "id": "job_...",
    "status": "queued",
    "printer_id": "prt_abc123",
    "payload_type": "template",
    "copies": 2,
    "is_test_mode": false,
    "created_at": "2026-10-17T12:00:00Z"
  }
}

Yanıtın biçimi OpenAPI dosyasındaki JobResponse / PrintJob şemasıdır; yukarıdaki değerler yer tutucudur, canlı servisten alınmış çıktı değildir.

Her oluşturmada X-Idempotency-Key gönderin. 24 saat boyunca tekrarlanan anahtar özgün işi döndürür ve hiçbir şey basmaz; ağ yeniden denemesinde çift etikete karşı korumanız budur. Birincisi hâlâ çalışırken aynı anahtarla gelen ikinci istek Retry-After ile 409 IDEMPOTENCY_IN_PROGRESS alır; aynı anahtar farklı bir gövdeyle gelirse 409 IDEMPOTENCY_KEY_REUSED alır.

Tuzak: bir iş failed döndükten sonra aynı anahtarı yeniden göndermek yeniden basmaz, eski başarısız işi döndürür. Anahtara bir deneme sayacı koyun, örneğin order-SO-10442-line-1:<deneme>. 4xx ile reddedilen istek anahtarını serbest bırakır; düzeltilmiş istek onu yeniden kullanabilir.