İş akışına webhook türünde bir Veri Kaynağı ekleyin ve onun için bir tetikleme anahtarı oluşturun.
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.

SORUN

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
Sisteminiz bir şey olduğunda tetikleme adresine JSON nesnesi POST etsin.
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?
| Durum | Kullanın |
|---|---|
| Sisteminiz webhook gönderebiliyor | Webhook tetikleyicisine gönderin |
| Yalnızca API'lerini okuyabiliyorsunuz | HTTP Fetcher ile yoklayın |
| Geliştiricileriniz iş bazında tam kontrol istiyor | REST API |
| Sisteminiz API çağrısı değil dosya yazıyor | Klasö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.
# 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ğiniz | Yanıt | Neden |
|---|---|---|
| JSON nesnesi, token doğru | çalışma başlar; alanlar {{sku}}, {{qty}} olur | Kayda ayrıca _triggeredBy, _triggerNodeId, _triggeredAt eklenir. |
| İmzalı token, başlık yok ya da yanlış | 401 INVALID_SIGNATURE | HMAC tam ham gövde üzerinden olmalı. |
| JSON dizisi ya da yalın değer | 400 INVALID_PAYLOAD | Yalnızca nesnenin alan adları vardır. Çok satır için satır başına bir istek gönderin. |
{} | 400 EMPTY_PAYLOAD | Bası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_DISABLED | Sessiz bir 200 siparişleri yutardı. |
| 512 KB'tan büyük | 413 PAYLOAD_TOO_LARGE | |
| Aynı token'a 250 ms'den sık istek | 429 RATE_LIMITED | Token başına taşkın freni. |
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'si | REST baskı API'si | |
|---|---|---|
| Kimlik bilgisi | URL'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ğrulanmaz | Evet, her istek |
| İstek başına satır | Bir kayıt | data içinde 1000'e kadar, toplu çağrıda 100 iş |
| Plan | Webhook 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 durum | Gö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.
DEVAMI
İlgili sayfalar
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