ENTEGRASYON / WEBHOOK / REST

Her API'yi Etiket Yazıcısına Bağlayın, İki Yönde

İki yol, ikisi de yazıcı kodu gerektirmez: sisteminiz bir LabelInn iş akışı tetikleme URL'sine (https://labelinn.com/v1/workflows/{id}/trigger/{token}) JSON nesnesi POST etsin ya da iş akışı API'nizi zamanlayıcıyla yoklayıp her yeni kalem için bir etiket bassın. Gönderilen alanlar etiket verisi olur.

ÜCRETSİZ PLAN · KREDİ KARTI YOK · WINDOWS / MAC / ANDROID / WEB
FİLO PANOSUCANLI DURUM
Her API'yi Etiket Yazıcısına Bağlayın, İki Yönde — LabelInn

SORUN

One LabelInn cloud driving many label printers

Mağaza sisteminizde, 3PL portalınızda ya da şirket içi bir araçta etiket verisi ve bir API var. Eksik olan arada duran parça: geliştiricilerinize yazıcı kodu yazdırmadan veya bunun için sunucu çalıştırmadan veriyi termal yazıcıya ulaştıracak bir şey.

LabelInn iş akışı o parça olabilir. Veri ona gönderilebilir ya da veriyi kendisi çekebilir.

API'si varsa basabilir. Webhook'a gönderin ya da LabelInn yoklasın. Ücretsiz başlayın →

01 / WEBHOOK

Gönderme: sisteminiz LabelInn'i çağırır

01

İş akışına webhook türünde bir Veri Kaynağı ekleyin ve onun için bir tetikleme anahtarı oluşturun.

02

Sisteminiz bir şey olduğunda tetikleme adresine JSON nesnesi POST etsin.

03

Nesne kayıt olur. Alanları tasarımı doldurur; Yönlendirici, Arama ve diğerleri her zamanki gibi çalışır.

Anahtar yalnızca o iş akışının giriş düğümünü başlatır; sızan bir adres başka hiçbir şeyi çalıştıramaz. İşleri doğrudan göndermek mi istiyorsunuz? REST API tasarım ve veriyi tek çağrıda alır.

02 / REST API

Çekme: LabelInn API'nizi yoklar

Diğer sistem dışarı çağrı yapamıyorsa ya da onu siz yönetmiyorsanız, bırakın LabelInn sorsun. Yoklaması açık bir HTTP Fetcher düğümü adresi belli aralıklarla (varsayılan 5 dakika) çağırır ve her yeni kalem için bir çalıştırma başlatır.

  • Liste yolu: cevabın içindeki liste, örneğin $.orders.
  • Anahtar alan: kalemi tanımlayan alan, örneğin order_id. Görülen kalemler bir daha basılmaz.
  • Başlıklar: API anahtarı veya token için.
  • Çıkarımlar: ek alanları seçen JSONPath ifadeleri.
  • Zaman aşımı: 1 ile 120 saniye; yavaş API adımı askıda bırakmak yerine düşürür.

03 / YOKLAMA

Sonucu geri bildirin

Sondaki Webhook düğümü sonucu herhangi bir HTTPS adresine POST eder; örneğin sisteminize etiketin basıldığını söyler.

04 / ENTEGRASYON

Hangisini seçmeli?

DurumKullanın
Sisteminiz webhook gönderebiliyorWebhook tetikleyicisine gönderin
Yalnızca API'lerini okuyabiliyorsunuzHTTP Fetcher ile yoklayın
Geliştiricileriniz iş bazında tam kontrol istiyorREST API
Sisteminiz API çağrısı değil dosya yazıyorKlasör izleme

GÖNDERME: TETİKLEME URL'Sİ

Webhook neyi kabul eder, neyi reddeder

Aşağıdaki sözleşme, bulut kodundaki gerçek authorizeTrigger işlevi her durumla çalıştırılarak denetlendi.

EXAMPLESHELL
# imzasız tetikleme (URL'deki token kimlik bilgisidir)
curl -X POST "https://labelinn.com/v1/workflows/WORKFLOW_ID/trigger/TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sku":"00417","qty":4}'

# imzalı tetikleme: ham gövdenin HMAC-SHA256'sı, hex, X-LabelInn-Signature olarak
SECRET=whsec_...
BODY='{"sku":"00417","qty":4}'
SIG="sha256=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')"
curl -X POST "https://labelinn.com/v1/workflows/WORKFLOW_ID/trigger/TOKEN" \
  -H "Content-Type: application/json" -H "X-LabelInn-Signature: $SIG" -d "$BODY"
GönderdiğinizYanıtNeden
JSON nesnesi, token doğruçalışma başlar; alanlar {{sku}}, {{qty}} olurKayda ayrıca _triggeredBy, _triggerNodeId, _triggeredAt eklenir.
İmzalı token, başlık yok ya da yanlış401 INVALID_SIGNATUREHMAC tam ham gövde üzerinden olmalı.
JSON dizisi ya da yalın değer400 INVALID_PAYLOADYalnızca nesnenin alan adları vardır. Çok satır için satır başına bir istek gönderin.
{}400 EMPTY_PAYLOADBasılacak bir şey yok.
Bilinmeyen, iptal edilmiş ya da başka iş akışının token'ı404 TRIGGER_NOT_FOUNDÜçü bilerek aynı görünür.
İş akışı kapalı409 WORKFLOW_DISABLEDSessiz bir 200 siparişleri yutardı.
512 KB'tan büyük413 PAYLOAD_TOO_LARGE
Aynı token'a 250 ms'den sık istek429 RATE_LIMITEDToken başına taşkın freni.
İmza örneği nasıl denetlendi

17 Ekim 2026'da yukarıdaki openssl satırı, aynı gövde ve gizli anahtar için bulut işlevinin kendi HMAC'iyle aynı sha256= değerini üretti.

GÖNDER, YOKLA VEYA REST

Tetikleme URL'si ne zaman, REST API ne zaman

İş akışı tetikleme URL'siREST baskı API'si
Kimlik bilgisiURL'deki token (isteğe bağlı olarak ayrıca HMAC gizli anahtarı)Bearer API anahtarı
Tasarımı ve yazıcıyı kim seçerİş akışı: Yönlendirici, Arama ve Yazdır düğümleriİsteğiniz: printer_id, design_id
API kotasından sayılır mıHayır, çağrı API anahtarıyla doğrulanmazEvet, her istek
İstek başına satırBir kayıtdata içinde 1000'e kadar, toplu çağrıda 100 iş
PlanWebhook kaynakları Webhook özelliğini ister: Pro (aylık $24.90) veya deneme; iş akışının kendisi Starter veya üstüPro veya deneme
En uygun olduğu durumGönderen yalnızca URL çağırabilen bir PLC geçidi, form, Zapier ya da ERP kuralıKod sizinse ve iş başına tam denetim istiyorsanız

REST yolu Etiket yazdırma API sayfasında; yinelenen baskıyı önleme için mükerrer etiket baskısını önleme sayfasına bakın.

SORULAR / SSS

Sık sorulan sorular

Webhook etiket baskısını tetikleyebilir mi?

Evet. İş akışına webhook Veri Kaynağı ekleyip tetikleme anahtarı oluşturun; tetikleme adresine JSON POST eden her sistem etiketi basan bir çalıştırma başlatır.

LabelInn bir API'yi yoklayıp yeni kalemleri basabilir mi?

Evet. Yoklaması açık HTTP Fetcher adresi belli aralıklarla çağırır, gösterdiğiniz listedeki her yeni kalem için çalıştırma başlatır ve kalem anahtarlarını hatırlar; hiçbir şey iki kez basılmaz.

Yoklama ne sıklıkla çalışır?

Varsayılan 5 dakika; aralığı düğümde siz belirlersiniz.

LabelInn sistemime etiketin basıldığını bildirebilir mi?

Evet. Webhook düğümü sonucu herhangi bir HTTPS adresine POST eder.

LabelInn webhook tetikleme URL'si nedir?

https://labelinn.com/v1/workflows/{workflowId}/trigger/{token}. Token'ı iş akışı düzenleyicisinde oluşturursunuz; URL yalnızca POST kabul eder ve gönderilen JSON nesnesi etiket verisi olur.

Webhook'u sahtelenemeyecek biçimde nasıl imzalarım?

Tetikleyiciyi gizli anahtarla oluşturun ve X-LabelInn-Signature: sha256=<hex> gönderin; bu, ham istek gövdesinin o anahtarla HMAC-SHA256'sıdır. Eksik ya da yanlış imza 401 ile reddedilir.

Tek webhook çağrısı birkaç etiket basabilir mi?

Tetikleyici çağrı başına bir JSON nesnesi alır. Tek istekte birkaç satır için REST API'yi (data 1000 satıra kadar dizi) ya da iş akışında Her Biri İçin döngüsünü kullanın.

SONRAKİ ADIM / LABELINN

API'niz, yazıcınız, arada hiçbir şey

Elinizdeki sistemi elinizdeki yazıcıya bağlayın. · Webhook tetikleyicileri · Tekrarsız API yoklama · Sonuç geri bildirimi

Ücretsiz başla →