Hent når du vil. Send når det gjelder.
SimplyPrint API er ideell når systemet ditt stiller spørsmålene. Webhooks er slik SimplyPrint forteller deg med én gang noe endres, uten polling, uten planlagte jobber og uten tapte hendelser.
Send hendelser i stedet for polling
En webhook er en URL du gir SimplyPrint. Hver gang noe du har abonnert på skjer i kontoen din, en utskrift starter, en jobb feiler, en køoppføring godkjennes eller en reservedel får lav lagerbeholdning, sender SimplyPrint en HTTP POST til den URL-en med hendelsesdataene. Ingen pollingløkker, ingen styr med rate limits, ingen «gikk vi glipp av den?», bare en hendelsesstrøm du kan koble til alt som snakker HTTP.
Opprett så mange webhooks du trenger. Velg nøyaktig hvilke hendelser hver av dem skal reagere på. Deaktiver én uten å slette den. Se hver levering i historikkvisningen. Det er den samme byggesteinen resten av nettet kjører på, nå koblet til printerflåten din.
Fire leveringsformater, ett webhook-system
SimplyPrint oppdager automatisk destinasjonen fra URL-en og formaterer nyttelasten slik at den passer. Pek en webhook mot Discord, så får du et riktig embed med farge, felter og tidsstempel. Pek den mot Slack, så får du en Slack Block Kit-melding. Pek den mot Microsoft Teams, så får du et adaptivt kort. Pek den mot noe annet, så får du ren rå JSON som du kan bruke som du vil.
Rent POST-innhold for Zapier, n8n, Make eller din egen backend.
Lim inn en webhook-URL for en kanal og få rike forhåndsvisninger uten bot.
Innebygde Block Kit-meldinger fra enhver innkommende Slack-webhook.
Adaptive Cards sendt til en Teams-arbeidsflyt eller en connector-URL.
Alle hendelser printerflåten din genererer, gruppert i ryddige kategorier
La hvert webhook abonnere på nøyaktig de hendelsene som betyr noe for det. En Discord-kanal for hele teamet kan kanskje bare bry seg om utskrift fullført og utskrift mislyktes. En Zapier-automatisering kan abonnere på køelement godkjent. Et vedlikeholdsdashbord kan ønske å motta alle maintenance.*-hendelser. Du bestemmer for hvert webhook.
- Utskriftsjobbhendelser - startet, satt på pause, gjenopptatt, avbrutt, fullført, mislyktes, printplate ryddet, objekter hoppet over
- Printerhendelser - AutoPrint-status, dysestørrelse, materiale, egendefinert tagg tilordnet / fjernet, status for ute av drift, AI-status, AI-feil oppdaget, falskt positivt AI-feilvarsel, maksimalt antall AutoPrint-sykluser
- Organisasjonshendelser, AutoPrint-status for konto, registrering av ny bruker, bruker venter på godkjenning
- Utskriftskø - element lagt til, slettet, flyttet, gjenopplivet, venter på godkjenning, godkjent, avslått, kø tømt
- Filament - opprettet, oppdatert, slettet, tilordnet printer, fjernet tilordning
- Vedlikehold - jobb opprettet / startet / fullført / avbrutt / forfalt / åpnet på nytt / oppdatert / slettet, problem rapportert / løst, reservedel opprettet / oppdatert / slettet, lager justert, lav lagerbeholdning, oppgave fullført / hoppet over, plan opprettet / oppdatert / slettet
- Saldo - belastet, refundert, påfylt, justert
- Kvote - ny forespørsel, forespørsel behandlet, justert, tilbakestilt
En payload-struktur det er enkelt å skrive kode mot
Hver webhook-levering i standardformat ser lik ut på utsiden: en konvolutt med event-navnet, et ISO-formatert timestamp og den opprinnelige webhook_id, som omslutter et data-objekt med en struktur spesifikk for hendelsen.data-objektet for en job.done-hendelse inneholder printjobben, printeren, filen, brukeren og forløpt tid. En filament.assigned-hendelse inneholder filamentet, printeren og hvilket verktøy det ble lagt på. En maintenance.job_overdue-hendelse inneholder jobben, printeren, ansvarlig bruker og opprinnelig forfallsdato. Samme konvolutt, hendelsesspesifikke data, så én switch-setning i koden din håndterer hele strømmen.
Se hvordan Weshape bruker Webhooks til å styre ~50 printers
Order queueing is a webhook that feeds into the SimplyPrint API.
Test, prøv og inspiser før du sender noe til produksjon
Webhooks skal være kjedelige. SimplyPrint gir deg tre verktøy for at de faktisk skal være det: se hva du vil motta, send en testhendelse og se gjennom hver levering som allerede har skjedd.
Send en testhendelse
Send en payload med reell struktur på forespørsel fra ethvert abonnement.
Eksempeldata
Se nøyaktige payload-strukturer før du skriver kode.
Leveringshistorikk
URL, HTTP-status, svartekst og tidsstempel for hver levering.
Slik ser webhookene dine ut etter levering
Discord-, Slack- og Teams-formatene vises som innebygde kort i disse appene, med formatert tittel, feltdelt innhold og valgfritt miniatyrbilde av printeren. Her er tre reelle leveringer fra en printerfarm som bruker SimplyPrint, fanget direkte fra en Discord-kanal. Konfigurer formatet én gang, så tar SimplyPrint seg av innebyggingen.
Forfalt vedlikehold
Et planlagt vedlikeholdsoppdrag har passert forfallsdatoen, oppdragsnavn, printer, prioritet, plan og gruppe, alt på ett kort.
Vedlikeholdsjobb opprettet
Et nytt vedlikeholdsoppdrag planlegges, printer, gruppe og prioritet vises umiddelbart i teamkanalen din.
Reservedelslager
Lagerendringer, slettede deler, justert lagerbeholdning og påfyll, leveres som separate hendelser slik at et arbeidsflytverktøy kan reagere på hver enkelt.
Valgfri kontroll med hemmelig nøkkel: bekreft at forespørselen faktisk kom fra SimplyPrint
Angi en egen hemmelig nøkkel for hver webhook, så sender SimplyPrint den med hver levering i X-SP-Secret-headeren, slik at mottakeren kan kontrollere at forespørselen faktisk kom fra oss og ikke fra en tilfeldig IP-adresse som gjettet URL-en din. Hopp over nøkkelen for webhooker i interne nettverk der du ikke trenger den. Bytt den hvis en nøkkel lekker. Tidligere leveringer blir ikke ugyldige, mens fremtidige bruker den nye nøkkelen.
Hver webhook er også individuelt aktivert / deaktivert, bruk bryteren for å sette en støyende integrasjon på pause uten å miste hendelsesabonnementet eller historikken.
Hva folk faktisk kobler opp
Dette er mønstrene vi oftest ser på tvers av printfarmer, skoler, makerspaces og produktteam som bruker SimplyPrint.
Send job.done og job.failed til teamets kanal.
Utløs faktura eller ordreoppfyllelse når et køelement godkjennes.
Varsle drift om forsinket vedlikehold eller lav beholdning av reservedeler.
Vis elevenes innsendinger for lærere i sanntid.
Push-delen av en komplett utvikleropplevelse
Webhooks passer naturlig sammen med resten av SimplyPrints utviklergrensesnitt:
- SimplyPrint API lar koden din hente enhver tilstand ved behov, printere, kø, filer, filament og jobber.
- Webhooks lar SimplyPrint pushe idet noe endrer seg, så du slipper å polle.
- SimplyPrint MCP-serveren lar AI-assistenter, som Claude og ChatGPT, lese data fra og utføre handlinger på den samme printerflåten gjennom et kvalitetssikret verktøyregister.
Plantilgang: hvilke planer inkluderer webhooks?
Webhooks er inkludert i abonnementene Print Farm og Enterprise uten ekstra kostnad. Ingen avgift per webhook eller levering, og ingen hendelsesgrenser.
| Funksjon / begrensning | Gratis | Basic | Pro | Printfarm | Enterprise | Skole | Cloud Slicer | Filamenthåndterer |
|---|---|---|---|---|---|---|---|---|
|
Webhooks
Komplett webhook-system med flere kanaler, vanlig JSON, Discord, Slack og Microsoft Teams, med fullstendig hendelseskatalog, valgfri verifisering med hemmelig nøkkel og historikk per levering.
|
Vil du vite mer om abonnementene våre?
Se full pris- og funksjonssammenligningOfte stilte spørsmål
Hvordan sender jeg hendelser til Discord, Slack eller Microsoft Teams?
discord.com/api/webhooks, hooks.slack.com/services eller en URL for en Teams-arbeidsflyt, og formaterer nyttelasten direkte for plattformen. Ingen botinstallasjon, ingen app, ingen mellomvare.Hvilke hendelser kan jeg abonnere på?
Hvordan bekrefter jeg at en forespørsel faktisk kom fra SimplyPrint?
Kan jeg se hva som er levert?
Kan jeg teste en webhook før den tas i bruk?
Hvordan skiller dette seg fra SimplyPrint API?
Hva med nye forsøk hvis serveren min er nede?
Forsøker SimplyPrint på nytt ved mislykkede leveringer?
Hvor lenge lagres leveringsforsøk?
Hvilke abonnementer inkluderer webhooks?
Trinnvis oppsettsveiledning
For en gjennomgang av hvordan du oppretter din første webhook, inkludert detaljer for URL-er til Discord, Slack og Microsoft Teams, se hele hjelpesenterartikkelen om webhooks.