Hämta när du vill. Skicka när det gäller.
SimplyPrint API är utmärkt när ditt system ställer frågorna. Med Webhooks meddelar SimplyPrint dig så fort något ändras, utan polling, utan schemalagda jobb och utan missade händelser.
Skicka händelser i stället för polling
En webhook är en URL som du ger SimplyPrint. Varje gång en händelse som du prenumererar på inträffar i ditt konto, till exempel att en utskrift startar, ett jobb misslyckas, en köpost godkänns eller lagersaldot för en reservdel blir lågt, skickar SimplyPrint en HTTP POST till den URL:en med händelsens payload. Inga pollingloopar, ingen hantering av rate limits, inget "missade vi den där?", bara en händelseström som du kan koppla till allt som talar HTTP.
Skapa så många webhooks du behöver. Välj exakt vilka händelser varje webhook ska reagera på. Inaktivera en utan att radera den. Granska varje leverans i historikvyn. Det är samma grundfunktion som resten av webben bygger på, nu integrerad med din flotta av 3D-skrivare.
Fyra leveransformat, ett webhooksystem
SimplyPrint identifierar automatiskt målet utifrån URL:en och formaterar payloaden så att den passar. Peka en webhook mot Discord så får du en riktig embed med färg, fält och tidsstämpel. Peka den mot Slack så får du ett Slack Block Kit-meddelande. Peka den mot Microsoft Teams så får du ett adaptivt kort. Peka den mot något annat så får du ren rå JSON som du kan göra vad du vill med.
Rent POST-innehåll för Zapier, n8n, Make eller din egen backend.
Klistra in en webhook-URL för kanalen och få rika inbäddningar, utan bot.
Inbyggda Block Kit-meddelanden från valfri inkommande Slack-webhook.
Anpassningsbara kort som skickas till ett Teams-arbetsflöde eller en anslutnings-URL.
Varje händelse som din flotta genererar, grupperad i tydliga kategorier
Prenumerera varje webhook på exakt de händelser som är relevanta för den. En Discord-kanal för hela teamet kanske bara behöver utskrift klar och utskrift misslyckades. En Zapier-automatisering kanske prenumererar på köobjekt godkänt. En underhållsöversikt kanske vill ha varje maintenance.*-händelse. Du avgör för varje webhook.
- Händelser för utskriftsjobb - startat, pausat, återupptaget, avbrutet, klart, misslyckat, byggplattan rensad, objekt överhoppade
- Skrivarhändelser - AutoPrint-status, munstycksstorlek, material, anpassad tagg tilldelad / borttagen, status ur drift, AI-status, AI-fel upptäckt, falskt positiv AI-feldetektering, högsta antal AutoPrint-cykler
- Organisationshändelser - kontots AutoPrint-status, ny användarregistrering, användare väntar på godkännande
- Utskriftskö - objekt tillagt, borttaget, flyttat, återställt, väntar på godkännande, godkänt, nekat, kön tömd
- Filament: skapat, uppdaterat, borttaget, tilldelat skrivare, borttaget från skrivare
- Underhåll - jobb skapat / startat / slutfört / avbrutet / förfallet / återöppnat / uppdaterat / borttaget, problem rapporterat / löst, reservdel skapad / uppdaterad / borttagen, lager justerat, lågt lagersaldo, uppgift slutförd / hoppad över, schema skapat / uppdaterat / borttaget
- Saldo: debiterat, återbetalat, påfyllt, justerat
- Kvot - ny förfrågan, förfrågan löst, justerad, återställd
Ett payloadformat som är enkelt att koda mot
Varje webhookleverans i standardformat ser likadan ut utåt: ett kuvert med händelsenamnet event, en ISO-timestamp och det ursprungliga webhook_id, som omsluter ett data-objekt vars struktur är specifik för händelsen.
Objektet data för en job.done-händelse innehåller utskriftsjobbet, skrivaren, filen, användaren och förfluten tid. En filament.assigned-händelse innehåller filamentet, skrivaren och vilket verktyg det hamnade på. En maintenance.job_overdue-händelse innehåller jobbet, skrivaren, ansvarig användare och ursprungligt förfallodatum. Samma format, händelsespecifika data, så en enda switch-sats i din kod hanterar hela flödet.
Veja como Weshape usa Webhooks para gerenciar ~50 printers
Order queueing is a webhook that feeds into the SimplyPrint API.
Testa, se exempel och granska innan du skickar något till produktion
Webhooks ska vara okomplicerade. SimplyPrint ger dig tre verktyg för att de ska vara det: granska vad du får, skicka ett testanrop och se alla tidigare leveranser.
Skicka en testhändelse
Skicka en payload med den verkliga strukturen på begäran från valfri prenumeration.
Exempel på payloads
Granska exakta payloadformat innan du skriver kod.
Leveranshistorik
URL, HTTP-status, svarstext och tidsstämpel för varje leverans.
Hur dina webhooks ser ut när de levererats
Formaten för Discord, Slack och Teams visas som vanliga inbäddade kort i respektive app, med formaterad titel, fältindelat innehåll och en valfri miniatyrbild av skrivaren. Här är tre verkliga meddelanden från en skrivarfarm som använder SimplyPrint, hämtade direkt från en Discord-kanal. Konfigurera formatet en gång, så sköter SimplyPrint inbäddningen.
Försenat underhåll
Ett schemalagt underhållsärende har passerat förfallodatumet: ärendenamn, skrivare, prioritet, schema och grupp, allt på ett kort.
Underhållsjobb skapat
Ett nytt underhållsjobb schemaläggs, skrivare, grupp och prioritet syns direkt i teamkanalen.
Reservdelslager
Lagerändringar, som att delar tas bort, lagersaldot justeras eller lagret fylls på, levereras som separata händelser så att ett arbetsflödesverktyg kan reagera på var och en.
Valfri verifiering med en delad hemlighet: bevisa att begäran verkligen kom från SimplyPrint
Ange en hemlig nyckel för varje webhook, så skickar SimplyPrint med den vid varje leverans i X-SP-Secret-headern. Mottagaren kan då kontrollera att begäran verkligen kom från oss och inte från en slumpmässig IP-adress som gissade din URL. Utelämna nyckeln för webhooks i interna nätverk där du inte behöver den. Byt den om den läcker. Tidigare leveranser blir inte ogiltiga, framtida använder den nya nyckeln.
Varje webhook kan också aktiveras/inaktiveras separat, växla reglaget för att pausa en störande integration utan att förlora händelseprenumerationen eller historiken.
Vad folk faktiskt kopplar ihop
Det här är mönstren vi oftast ser hos printfarmer, skolor, makerspaces och produktteam som använder SimplyPrint.
Skicka job.done och job.failed till teamets kanal.
Utlös fakturering eller orderhantering när en köpost godkänns.
Avisera driftteamet om försenat underhåll eller lågt lager av reservdelar.
Visa elevernas inlämningar för lärarna i realtid.
Push-delen av en komplett utvecklarupplevelse
Webhooks passar naturligt ihop med resten av SimplyPrints utvecklarfunktioner:
- SimplyPrint API låter din kod hämta valfri status vid behov: skrivare, kö, filer, filament och jobb.
- Webhooks låter SimplyPrint skicka direkt när något ändras, så att du inte behöver polla.
- SimplyPrint MCP-server låter AI-assistenter (Claude, ChatGPT) läsa och agera i samma flotta via ett granskat verktygsregister.
Planåtkomst: vilka planer innehåller webhooks?
Webhooks ingår utan extra kostnad i abonnemangen Print Farm och Enterprise. Ingen avgift per webhook eller leverans, inga begränsningar av antal händelser.
| Recurso / limite | Grátis | Básico | Pro | Print farm | Enterprise | Escola | Cloud Slicer | Gerenciador de filamento |
|---|---|---|---|---|---|---|---|---|
|
Webhooks
Fullständigt flerkanaligt webhooksystem, vanlig JSON, Discord, Slack och Microsoft Teams, med komplett händelsekatalog, valfri verifiering med hemlighet och historik för varje leverans.
|
Quer saber mais sobre nossos planos?
Ver preços e comparação completa de recursosVanliga frågor
Hur skickar jag händelser till Discord, Slack eller Microsoft Teams?
discord.com/api/webhooks, hooks.slack.com/services eller Teams workflow-URL:er) och formaterar nyttolasten specifikt för den plattformen. Ingen botinstallation, ingen app, ingen mellanprogramvara.Vilka händelser kan jag prenumerera på?
Hur verifierar jag att en begäran verkligen kom från SimplyPrint?
Kan jag se vad som har levererats?
Kan jag testa en webhook innan den tas i drift?
Hur skiljer sig detta från SimplyPrint API?
Hur är det med återförsök om min server ligger nere?
Försöker SimplyPrint skicka misslyckade leveranser igen?
Hur länge sparas leveransförsök?
Vilka planer inkluderar webhooks?
Steg-för-steg-guide för installation
För en guide till att skapa din första webhook, inklusive detaljer för URL:er till Discord, Slack och Microsoft Teams, se hela webhooks-artikeln i hjälpcentret.