Pobieranie, gdy potrzeba. Wysyłanie, gdy ma znaczenie.
API SimplyPrint sprawdza się, gdy pytania zadaje własny system. Webhooks pozwalają SimplyPrint powiadamiać system od razu po zmianie, bez odpytywania, zaplanowanych zadań i pomijania zdarzeń.
Wysyłanie zdarzeń zamiast odpytywania
Webhook to URL przekazywany do SimplyPrint. Za każdym razem, gdy na koncie wystąpi zasubskrybowane zdarzenie, na przykład rozpocznie się wydruk, zadanie zakończy się niepowodzeniem, pozycja kolejki zostanie zatwierdzona lub zapas części spadnie do niskiego poziomu, SimplyPrint wysyła żądanie HTTP POST na ten URL z danymi zdarzenia. Bez pętli odpytywania, zarządzania limitami żądań ani zastanawiania się, czy coś pominięto. To strumień zdarzeń, który można podłączyć do wszystkiego obsługującego HTTP.
Można utworzyć tyle webhooków, ile potrzeba. Dla każdego można wybrać dokładnie interesujące zdarzenia. Webhook można wyłączyć bez usuwania. Każde dostarczenie można sprawdzić w widoku historii. To ten sam mechanizm, na którym działa reszta internetu, teraz połączony z flotą drukarek 3D.
Cztery formaty dostarczania, jeden system webhooków
SimplyPrint automatycznie wykrywa miejsce docelowe na podstawie URL i odpowiednio formatuje dane. Skierowanie webhooka do usługi Discord daje prawidłowy embed z kolorem, polami i znacznikiem czasu. Skierowanie go do usługi Slack daje wiadomość Slack Block Kit. Skierowanie go do Microsoft Teams daje kartę adaptacyjną. W każdym innym przypadku otrzymuje się czysty, surowy JSON, który można dowolnie wykorzystać.
Przejrzysta treść POST dla Zapier, n8n, Make lub własnego backendu.
Wklejenie URL webhooka kanału zapewnia rozbudowane osadzone wiadomości, bez bota.
Natywne komunikaty Block Kit z dowolnego przychodzącego webhooka Slack.
Karty adaptacyjne wysyłane do przepływu pracy Teams lub adresu URL łącznika.
Każde zdarzenie generowane przez flotę, pogrupowane w przejrzyste kategorie
Każdemu webhookowi można przypisać dokładnie te zdarzenia, które są dla niego istotne. Kanał Discord dla całego zespołu może wymagać tylko druk ukończony i druk nieudany. Automatyzacja Zapier może subskrybować element kolejki zatwierdzony. Pulpit konserwacji może wymagać każdego zdarzenia maintenance.*. Ustawienia określa się dla każdego webhooka.
- Zdarzenia zadań drukowania - rozpoczęto, wstrzymano, wznowiono, anulowano, ukończono, wystąpił błąd, zdjęto wydruk ze stołu, pominięto obiekty
- Zdarzenia drukarek - stan AutoPrint, rozmiar dyszy, materiał, przypisanie / odłączenie własnego tagu, stan niesprawności, stan AI, wykrycie nieudanego wydruku przez AI, fałszywy alarm AI, maksymalna liczba cykli AutoPrint
- Zdarzenia organizacji - stan AutoPrint konta, rejestracja nowego użytkownika, użytkownik oczekujący na zatwierdzenie
- Kolejka wydruków - element dodano, usunięto, przeniesiono, przywrócono, oczekuje na zatwierdzenie, zatwierdzono, odrzucono, kolejkę opróżniono
- Filament: utworzenie, aktualizacja, usunięcie, przypisanie do drukarki, usunięcie przypisania
- Konserwacja: zlecenie utworzone / rozpoczęte / ukończone / anulowane / zaległe / ponownie otwarte / zaktualizowane / usunięte, problem zgłoszony / rozwiązany, część zamienna utworzona / zaktualizowana / usunięta, zapas skorygowany, niski stan zapasów, zadanie wykonane / pominięte, harmonogram utworzony / zaktualizowany / usunięty
- Saldo, obciążane, zwracane, doładowywane, korygowane
- Limit - nowe żądanie, żądanie rozpatrzono, dostosowano, zresetowano
Struktura danych łatwa do obsługi w kodzie
Każde dostarczenie webhooka w standardowym formacie wygląda z zewnątrz tak samo: koperta z nazwą zdarzenia event, znacznikiem czasu ISO timestamp i źródłowym webhook_id, otaczająca obiekt data, którego struktura zależy od zdarzenia.
Obiekt data dla zdarzenia job.done zawiera zadanie wydruku, drukarkę, plik, użytkownika i czas trwania. Zdarzenie filament.assigned zawiera filament, drukarkę i informację, do którego narzędzia został przypisany. Zdarzenie maintenance.job_overdue zawiera zadanie, drukarkę, odpowiedzialnego użytkownika i pierwotną datę wykonania. Ta sama koperta, dane zależne od zdarzenia, więc cały strumień obsługuje jedna instrukcja switch w kodzie.
Zobacz, jak Weshape używa Webhooks do zarządzania flotą ~50 printers
Order queueing is a webhook that feeds into the SimplyPrint API.
Testować, generować próbki i sprawdzać, zanim cokolwiek trafi do produkcji
Webhooks powinny być proste. SimplyPrint oferuje trzy narzędzia, dzięki którym tak jest: można sprawdzić otrzymywane dane, wysłać testowe wywołanie i przejrzeć historię wszystkich dostarczeń.
Wyślij zdarzenie testowe
Wyślij na żądanie payload o rzeczywistej strukturze z dowolnej subskrypcji.
Przykładowe payloady
Dokładne struktury payloadów można przejrzeć przed napisaniem kodu.
Historia dostaw
URL, status HTTP, treść odpowiedzi i znacznik czasu każdej dostawy.
Jak wyglądają webhooki po dostarczeniu
Formaty Discord, Slack i Teams wyświetlają się w tych aplikacjach jako natywne karty osadzone, z bogatym tytułem, uporządkowanymi polami ładunku i opcjonalną miniaturą drukarki. Poniżej znajdują się trzy rzeczywiste powiadomienia z farmy druku korzystającej z SimplyPrint, przechwycone bezpośrednio z kanału Discord. Wystarczy raz skonfigurować format, SimplyPrint zajmuje się osadzeniem.
Zaległa konserwacja
Zaplanowane zlecenie konserwacyjne przekroczyło termin, nazwa zlecenia, drukarka, priorytet, harmonogram i grupa na jednej karcie.
Utworzono zlecenie konserwacyjne
Zaplanowano nowe zlecenie konserwacyjne. Drukarka, grupa i priorytet od razu pojawiają się na kanale zespołu.
Magazyn części zamiennych
Zmiany w magazynie, usunięcie części, korekta stanów i uzupełnienie zapasów, są przekazywane jako osobne zdarzenia, aby narzędzie do automatyzacji mogło reagować na każde z nich.
Opcjonalna weryfikacja sekretu, aby potwierdzić, że żądanie rzeczywiście pochodzi od SimplyPrint
Dla każdego webhooka można ustawić sekret, a SimplyPrint wysyła go z każdą wysyłką w nagłówku X-SP-Secret, aby odbiorca mógł sprawdzić, czy żądanie rzeczywiście pochodzi od nas, a nie z losowego adresu IP, który odgadł URL. W wewnętrznych webhookach sieciowych, gdzie nie jest potrzebny, sekret można pominąć. W razie wycieku klucza można go wymienić, wcześniejsze wysyłki nie są unieważniane, a przyszłe użyją nowego klucza.
Każdy webhook można też niezależnie włączyć lub wyłączyć, a przełączenie przełącznika pozwala wstrzymać hałaśliwą integrację bez utraty subskrypcji zdarzeń ani historii.
Co ludzie naprawdę integrują
To najczęstsze schematy spotykane w farmach druku, szkołach, makerspace’ach i zespołach produktowych korzystających z SimplyPrint.
Wysyłanie job.done i job.failed na kanał zespołu.
Automatyczne uruchamianie fakturowania lub realizacji po zatwierdzeniu pozycji kolejki wydruków.
Powiadamianie działu operacyjnego o zaległej konserwacji lub niskich stanach części zamiennych.
Przekazywanie nauczycielom zgłoszeń uczniów w czasie rzeczywistym.
Część push pełnego zestawu dla programistów
Webhooks naturalnie uzupełniają pozostałe narzędzia deweloperskie SimplyPrint:
- API SimplyPrint pozwala kodowi pobierać na żądanie dowolny stan: drukarki, kolejkę, pliki, filament, zadania.
- Webhooks pozwalają SimplyPrint wysyłać informacje w chwili zmiany, bez konieczności odpytywania.
- Serwer SimplyPrint MCP umożliwia asystentom AI (Claude, ChatGPT) odczytywanie danych i wykonywanie działań w tej samej flocie przez zweryfikowany rejestr narzędzi.
Dostęp w planach: które plany obejmują webhooki?
Webhooks są dostępne bez dodatkowych opłat w planach Print Farm i Enterprise. Bez opłat za webhooki i dostarczenia, bez limitów zdarzeń.
| Funkcja / limit | Za darmo | Basic | Pro | Farma druku | Enterprise | Szkoła | Slicer w chmurze | Menedżer filamentu |
|---|---|---|---|---|---|---|---|---|
|
Webhooks
Pełny wielokanałowy system webhooków: zwykły JSON, Discord, Slack i Microsoft Teams, z kompletnym katalogiem zdarzeń, opcjonalną weryfikacją sekretu i historią poszczególnych dostarczeń.
|
Więcej informacji o naszych planach?
Zobacz pełny cennik i porównanie funkcjiNajczęściej zadawane pytania
Jak wysyłać zdarzenia do Discord, Slack lub Microsoft Teams?
discord.com/api/webhooks, hooks.slack.com/services, czy adres URL przepływu Teams, a dane zostaną sformatowane natywnie dla danej platformy. Bez instalowania bota, aplikacji ani oprogramowania pośredniczącego.Jakie zdarzenia można subskrybować?
Jak sprawdzić, czy żądanie pochodzi z SimplyPrint?
Czy można sprawdzić, co zostało dostarczone?
Czy można przetestować webhook przed wdrożeniem?
Czym różni się to od API SimplyPrint?
A co z ponawianiem prób, gdy serwer jest niedostępny?
Czy SimplyPrint ponawia nieudane próby dostarczenia?
Jak długo przechowywane są próby dostarczenia?
Które plany obejmują webhooki?
Przewodnik konfiguracji krok po kroku
Pełny artykuł pomocy o webhookach zawiera instrukcję tworzenia pierwszego webhooka, w tym szczegóły URL dla Discord, Slack i Microsoft Teams.