3D yazıcı filonuz için gerçek zamanlı push etkinlikleri

Webhooks: bir şey olduğunda anında bildirim alın

Bir baskı başladığında, iş başarısız olduğunda, kuyruk öğesi eklendiğinde, yedek parça azaldığında veya filament yeniden atandığında SimplyPrint, olayı saniyeler içinde URL'nize POST edebilir. Kod yazmadan olayları Discord, Slack veya Microsoft Teams'e aktarın ya da ham JSON verisiyle kendi otomasyonunuzu oluşturun.

Kom gratis i gang Mer info og guide
Funksjonsbilde

İstediğinizde çekin. Gerektiğinde gönderin.

Soruları sisteminiz soruyorsa SimplyPrint API idealdir. Webhooks, bir şey değiştiği anda SimplyPrint'in size bildirme yöntemidir. Yoklama, planlanmış işler veya kaçırılan olaylar yoktur.

Funksjonsbilde

Yoklama yerine olayları iletin

Webhook, SimplyPrint'e verdiğiniz bir URL'dir. Hesabınızda abone olduğunuz bir olay gerçekleştiğinde, örneğin baskı başladığında, iş başarısız olduğunda, kuyruk öğesi onaylandığında veya yedek parça stoğu azaldığında, SimplyPrint olay yükünü HTTP POST ile bu URL'ye gönderir. Yoklama döngüleri, hız sınırı yönetimi veya "bunu kaçırdık mı?" kaygısı yoktur. Yalnızca HTTP kullanan her şeye bağlayabileceğiniz bir olay akışı vardır.

İhtiyacınız kadar webhook oluşturun. Her birinin tam olarak hangi olaylarda tetikleneceğini seçin. Birini silmeden devre dışı bırakın. Geçmiş görünümünde her gönderimi inceleyin. Web'in geri kalanının kullandığı temel yapı aynıdır, artık 3D yazıcı filonuza bağlı.

Dört teslimat biçimi, tek webhook sistemi

SimplyPrint hedefi URL'den otomatik algılar ve veri yükünü uygun biçimde düzenler. Bir webhook'u Discord'a yönlendirdiğinizde renk, alanlar ve zaman damgası içeren düzgün bir gömülü mesaj alırsınız. Slack'e yönlendirdiğinizde Slack Block Kit mesajı, Microsoft Teams'e yönlendirdiğinizde uyarlanabilir kart alırsınız. Başka bir yere yönlendirdiğinizde istediğiniz gibi kullanabileceğiniz temiz ham JSON alırsınız.

Ham JSON

Zapier, n8n, Make veya kendi backend'iniz için temiz POST gövdesi.

Discord

Kanal webhook URL'sini yapıştırın ve botsuz zengin yerleştirmeler elde edin.

Slack

Slack gelen webhook'ları üzerinden yerel Block Kit mesajları.

Microsoft Teams

Teams iş akışına veya bağlayıcı URL'sine gönderilen uyarlanabilir kartlar.

Funksjonsbilde

Filonuzun ürettiği her olay, düzenli kategorilerde gruplandırılmış

Her webhook'i yalnızca kendisi için önemli olaylara abone edin. Ekip genelindeki bir Discord kanalı yalnızca baskı tamamlandı ve baskı başarısız oldu olaylarıyla ilgilenebilir. Bir Zapier otomasyonu kuyruk öğesi onaylandı olayına abone olabilir. Bakım gösterge paneli her maintenance.* olayını isteyebilir. Her webhook için siz karar verirsiniz.

  • Baskı işi olayları: Başlatıldı, duraklatıldı, sürdürüldü, iptal edildi, tamamlandı, başarısız oldu, tabla boşaltıldı, nesneler atlandı
  • Yazıcı olayları: AutoPrint durumu, nozül boyutu, malzeme, özel etiket atandı / kaldırıldı, hizmet dışı durumu, AI durumu, AI arızası algılandı, hatalı AI arıza uyarısı, AutoPrint azami döngü sayısı
  • Kuruluş etkinlikleri - hesap AutoPrint durumu, yeni kullanıcı kaydı, onay bekleyen kullanıcı
  • Baskı kuyruğu: Öğe eklendi, silindi, taşındı, geri yüklendi, onay bekliyor, onaylandı, reddedildi, kuyruk boşaltıldı
  • Filament: Oluşturuldu, güncellendi, silindi, yazıcıya atandı, ataması kaldırıldı
  • Bakım: İş oluşturuldu / başlatıldı / tamamlandı / iptal edildi / süresi geçti / yeniden açıldı / güncellendi / silindi; sorun bildirildi / çözüldü; yedek parça oluşturuldu / güncellendi / silindi; stok ayarlandı, düşük stok; görev tamamlandı / atlandı; plan oluşturuldu / güncellendi / silindi
  • Bakiye: Ücret alındı, iade edildi, para eklendi, düzenlendi
  • Kota: Yeni istek, istek çözüldü, ayarlandı, sıfırlandı
Kullanıma hazır 60'tan fazla farklı olay vardır ve her yeni özellik yayınlandığında yenileri eklenir.

Kodla işlemesi kolay bir veri yükü yapısı

Normal biçimli her webhook teslimatı dışarıdan aynı görünür: olaya özel biçimdeki data nesnesini saran event adı, ISO timestamp ve kaynak webhook_id içeren zarf.

job.done olayının data nesnesi baskı işi, yazıcı, dosya, kullanıcı ve geçen süreyi içerir. filament.assigned olayı filament, yazıcı ve atandığı aracı içerir. maintenance.job_overdue olayı bakım işi, yazıcı, sorumlu kullanıcı ve başlangıçta belirlenen son tarihi içerir. Aynı zarf, olaya özel veri. Böylece kodunuzdaki tek switch ifadesi tüm akışı işler.

Funksjonsbilde
Weshape
Kundehistorie

Se hvordan Weshape bruker Webhooks til å styre ~50 printers

Order queueing is a webhook that feeds into the SimplyPrint API.
- Weshape, Kolind, Denmark
Les historien til Weshape

Üretime göndermeden önce test edin, örnekleyin ve inceleyin

Webhooks sıkıcı olmalı. SimplyPrint, bunu sağlayan üç araç sunar: alacağınız verileri inceleyin, test çağrısı gönderin ve daha önce gerçekleşen tüm gönderimleri gözden geçirin.

Test olayı gönder

Herhangi bir abonelikten istediğiniz zaman gerçek biçimli bir yük gönderin.

Örnek yükler

Kod yazmadan önce tam veri yükü yapılarını inceleyin.

Teslimat geçmişi

Her teslimat için URL, HTTP durumu, yanıt gövdesi ve zaman damgası.

ramme ramme ramme

Teslim edildikten sonra webhook'larınızın görünümü

Discord, Slack ve Teams biçimleri bu uygulamalarda yerel gömme kartları olarak görüntülenir: zengin başlık, alanlara ayrılmış veri yükü, isteğe bağlı yazıcı küçük resmi. Aşağıda, SimplyPrint kullanan bir baskı çiftliğinden doğrudan Discord kanalından alınmış üç gerçek gönderim var. Biçimi bir kez yapılandırın; gömmeyi SimplyPrint halleder.

ramme ramme ramme

Bakım gecikti

Planlanmış bir bakım işinin son tarihi geçti: iş adı, yazıcı, öncelik, zamanlama ve grup, hepsi tek kartta.

Bakım işi oluşturuldu

Yeni bir bakım işi planlanır, yazıcı, grup ve öncelik anında ekip kanalınızda görünür.

Yedek parça envanteri

Envanter değişiklikleri, parça silme, stok ayarlama ve yeniden stoklama, iş akışı aracının her birine tepki verebilmesi için ayrı olaylar olarak teslim edilir.

İsteğe bağlı gizli anahtar doğrulaması; isteğin gerçekten SimplyPrint'ten geldiğini kanıtlar

Her webhook için bir gizli anahtar belirleyin. SimplyPrint bunu her teslimatla birlikte X-SP-Secret başlığında gönderir; böylece alıcınız isteğin gerçekten bizden geldiğini, URL'nizi tahmin eden rastgele bir IP'den gelmediğini doğrulayabilir. Gerek duymadığınız iç ağ webhook'larında gizli anahtarı atlayın. Anahtar sızdığında yenileyin; geçmiş teslimatlar geçersiz kılınmaz, gelecektekiler yeni anahtarı kullanır.

Her webhook ayrıca bağımsız olarak etkinleştirilir / devre dışı bırakılır. Gürültülü bir entegrasyonu olay aboneliğini veya geçmişini kaybetmeden duraklatmak için anahtarı çevirin.

Funksjonsbilde

Kişilerin gerçekten bağladıkları

SimplyPrint kullanan baskı çiftlikleri, okullar, makerspace'ler ve ürün ekiplerinde en sık gördüğümüz kalıplar bunlardır.

Discord güncellemeleri

job.done ve job.failed olaylarını ekibinizin kanalına gönderin.

Zapier / n8n

Bir kuyruk öğesi onaylandığında fatura veya sipariş karşılama işlemini tetikleyin.

Bakım uyarıları

Gecikmiş bakım veya azalan yedek parça stoğu için operasyon ekibine bildirim gönderin.

Sınıf gösterge paneli

Öğrenci gönderimlerini öğretmenlere gerçek zamanlı gösterin.

Tam bir geliştirici deneyiminin push tarafı

Webhooks, SimplyPrint geliştirici araçlarının geri kalanıyla doğal biçimde uyumludur:

  • SimplyPrint API, kodunuzun gerektiğinde yazıcılar, kuyruk, dosyalar, filament ve işler dâhil tüm durumları çekmesini sağlar.
  • Webhooks, bir şey değiştiği anda SimplyPrint'in göndermesini sağlar, böylece yoklama yapmanız gerekmez.
  • SimplyPrint MCP sunucusu, AI asistanlarının (Claude, ChatGPT) incelenmiş araç kaydı üzerinden aynı filoyu okuyup yönetmesini sağlar.
İçlerinden herhangi birini veya üçünü de kullanın. Aynı kimlik doğrulamasını, aynı izin modelini ve aynı veri yapısını paylaşırlar, bu nedenle bir webhook yükündeki yazıcı, API çağrınızın döndürdüğü yazıcı nesnesiyle aynıdır.

Funksjonsbilde

Plan erişimi: webhooks hangi planlara dâhildir?

Webhooks, Print Farm ve Enterprise planlarına ek ücret olmadan dahildir. Webhook başına ücret, teslimat başına ücret ve olay sınırı yoktur.

Funksjon / begrensning Gratis Basic Pro Printfarm Enterprise Skole Cloud Slicer Filamenthåndterer
Webhooks
Tam çok kanallı webhook sistemi: standart JSON, Discord, Slack ve Microsoft Teams, eksiksiz olay kataloğu, isteğe bağlı gizli anahtar doğrulaması ve teslimat bazlı geçmiş.

Vil du vite mer om abonnementene våre?

Se full pris- og funksjonssammenligning

Sık sorulan sorular

Kanalın webhook URL'sini SimplyPrint'e yapıştırın, hepsi bu. Hedefi URL'den algılarız (discord.com/api/webhooks, hooks.slack.com/services veya herhangi bir Teams iş akışı URL'si) ve yükü ilgili platformun biçimine uygun olarak hazırlarız. Bot kurulumu, uygulama veya ara katman gerekmez.
Sekiz kategoride 60'tan fazla olay: yazdırma işleri, yazıcı durumu, organizasyon, baskı kuyruğu, filament, bakım, bakiye ve kota. Her webhook kendi alt kümesine abone olur; böylece bir Discord kanalı yalnızca job.done ve job.failed alırken, Zapier entegrasyonu queue.item_approved için dinleyebilir. Her büyük özellik sürümüyle yeni olaylar eklenir.
Webhook'a bir gizli anahtar atayın. SimplyPrint bunu her teslimatla birlikte X-SP-Secret başlığında gönderir; böylece alıcınız saklanan değerle karşılaştırıp eşleşmeyenleri reddedebilir. Gizli anahtar her webhook için ayrıdır; bu nedenle diğerlerine dokunmadan tek bir entegrasyonun anahtarını yenileyebilirsiniz.
Evet. Her teslimat hedef URL, istek gövdesi, HTTP yanıt kodu ve zaman damgasıyla kaydedilir. Tam teslimat geçmişini görmek için herhangi bir webhook'u açın. Böylece yanlış yapılandırılmış uç nokta veya geçici kesinti hiçbir zaman tahmine kalmaz.
Evet. Her olay aboneliğinde "test gönder" düğmesi vardır. SimplyPrint gerçek biçimli yük oluşturur (varsa hesabınızdaki gerçek bir varlığı, yoksa sentetik örneği kullanır) ve isteğe bağlı olarak webhook'a gönderir. Ayrıca her olayın örnek yüklerine göz atabilirsiniz. Böylece aşağı akış kodunuz ilk gerçek olay gelmeden hazır olur.
API çekmedir: kodunuz gerektiğinde SimplyPrint'ten durum ister. Webhooks itmedir: SimplyPrint bir şey değiştiği anda kodunuza bildirir. Yoklama, hız sınırı yönetimi veya kaçırılan olay yoktur. Gerçek entegrasyonların çoğu ikisini de kullanır: sorgulamak için API, tepki vermek için webhooks.
Teslimatlar ayrı bir ileticiden gönderilir ve yanıt kodu, istek gövdesi ve zaman damgası her deneme için günlüğe kaydedilir, böylece kesinti webhook geçmişinizde görünür. Alıcınızı idempotent olacak şekilde oluşturun, her teslimat kendi günlük kimliğini taşır, ve kesinti sırasında kaçırmış olabileceğiniz durumları uzlaştırmak için API'yi kullanın.
Evet. Başarısız teslimatlar (2xx dışı yanıt veya zaman aşımı) sonraki 24 saat boyunca üstel gecikmeyle yeniden denenir. Ardından kalıcı olarak başarısız işaretlenir ve teslimat geçmişinde gösterilir.
Teslim denemeleri, yük ve yanıt koduyla birlikte, panelde her webhook için erişilebilen webhook teslimat geçmişinde 30 gün saklanır.
Webhooks, Print Farm, School (Eğitim) ve Enterprise planlarına dahildir. Webhook başına ücret, teslimat başına ücret ve olay sınırı yoktur.

Adım adım kurulum kılavuzu

Discord, Slack ve Microsoft Teams URL'lerine özel ayrıntılar da dahil olmak üzere ilk webhook'unuzu oluşturma adımları için kapsamlı webhook'lar yardım merkezi makalesine bakın.

Innholdsfortegnelse