जब चाहें इम्पोर्ट करें। जब ज़रूरी हो, भेजें।
SimplyPrint API तब बेहतरीन है जब आपका सिस्टम सवाल पूछता है। Webhooks से SimplyPrint कुछ बदलते ही आपको बताता है, बिना polling, scheduled jobs या छूटी events के।
polling की जगह इवेंट भेजें
webhook एक URL है जो आप SimplyPrint को देते हैं। आपके खाते में जिस भी इवेंट की आपने सदस्यता ली है, जैसे प्रिंट शुरू होना, जॉब असफल होना, कतार आइटम मंजूर होना या स्पेयर पार्ट का स्टॉक कम होना, हर बार SimplyPrint उस URL पर इवेंट payload के साथ HTTP POST भेजता है। कोई polling loop नहीं, rate-limit संभालना नहीं, “क्या वह छूट गया?” नहीं, बस एक इवेंट स्ट्रीम जिसे HTTP बोलने वाली किसी भी चीज़ से जोड़ा जा सकता है।
ज़रूरत जितने webhooks बनाएँ। हर webhook के लिए exact event चुनें। हटाए बिना disable करें। history view में हर delivery देखें। यही वह मूल तकनीक है जिस पर बाकी web चलता है, अब आपके 3D प्रिंटर बेड़े से जुड़ी।
चार delivery formats, एक webhook system
SimplyPrint URL से गंतव्य स्वतः पहचानता है और payload को उसके अनुसार format करता है। Webhook को Discord पर भेजें, आपको रंग, fields और timestamp वाला सही embed मिलता है। इसे Slack पर भेजें, आपको Slack Block Kit message मिलता है। इसे Microsoft Teams पर भेजें, आपको adaptive card मिलता है। इसे किसी और जगह भेजें, आपको साफ़ raw JSON मिलता है, जिससे आप जो चाहें कर सकते हैं।
Zapier, n8n, Make या अपने backend के लिए साफ़ POST body।
channel webhook URL paste करें और rich embeds पाएँ, bot नहीं चाहिए।
किसी Slack incoming webhook से नेटिव Block Kit messages।
Teams workflow या connector URL पर भेजे गए adaptive card।
आपकी fleet द्वारा जनरेट हर इवेंट, साफ़ श्रेणियों में समूहित
हर webhook को सिर्फ़ उन इवेंट की सदस्यता दें, जो उसके लिए ज़रूरी हैं। पूरी टीम के Discord चैनल के लिए शायद केवल print finished और print failed मायने रखते हों। Zapier automation queue item approved की सदस्यता ले सकता है। एक मेंटेनेंस डैशबोर्ड हर maintenance.* इवेंट चाह सकता है। हर webhook के लिए निर्णय आपका है।
- प्रिंट जॉब इवेंट - शुरू, रोके गए, फिर शुरू, रद्द, पूर्ण, विफल, बेड खाली किया गया, ऑब्जेक्ट छोड़े गए
- प्रिंटर इवेंट - AutoPrint स्थिति, nozzle आकार, सामग्री, कस्टम टैग असाइन / हटाया गया, आउट-ऑफ़-ऑर्डर स्थिति, AI स्थिति, AI विफलता पता चली, AI फॉल्स पॉज़िटिव, AutoPrint अधिकतम चक्र
- संगठन events, खाते की AutoPrint स्थिति, नया user signup, user approval लंबित
- प्रिंट कतार - आइटम जोड़ा, हटाया, स्थानांतरित, पुनर्सक्रिय, अनुमोदन लंबित, अनुमोदित, अस्वीकृत, कतार खाली की गई
- Filament - बनाया गया, अपडेट किया गया, हटाया गया, प्रिंटर को असाइन किया गया, असाइनमेंट हटाया गया
- मेंटेनेंस: जॉब बनाया / शुरू / पूरा / रद्द / विलंबित / फिर खोला / अपडेट / हटाया गया, समस्या रिपोर्ट / हल की गई, स्पेयर पार्ट बनाया / अपडेट / हटाया गया, स्टॉक समायोजित, कम स्टॉक, टास्क पूरा / छोड़ा गया, शेड्यूल बनाया / अपडेट / हटाया गया
- शेष राशि, चार्ज, रिफंड, टॉप-अप, समायोजन
- कोटा - नया अनुरोध, अनुरोध पूरा हुआ, समायोजित किया गया, रीसेट
ऐसा payload format जिसके लिए code लिखना आसान है
हर नियमित-फॉर्मेट webhook डिलीवरी बाहर से एक जैसी दिखती है: event नाम, ISO timestamp और मूल webhook_id वाला एक एनवेलप, जो data ऑब्जेक्ट को समेटता है, जिसका रूप इवेंट के अनुसार अलग होता है।
job.done इवेंट के लिए data ऑब्जेक्ट में print job, प्रिंटर, file, उपयोगकर्ता और बीता समय शामिल होता है। filament.assigned इवेंट में filament, प्रिंटर और वह tool शामिल होता है जिस पर उसे असाइन किया गया। maintenance.job_overdue इवेंट में job, प्रिंटर, जिम्मेदार उपयोगकर्ता और मूल due date शामिल होती है। envelope एक ही है, पर डेटा इवेंट-विशिष्ट है, इसलिए आपके कोड में एक switch statement पूरी stream संभालता है।
देखें कि Weshape, ~50 printers चलाने के लिए Webhooks का उपयोग कैसे करता है
Order queueing is a webhook that feeds into the SimplyPrint API.
टेस्ट करें, सैंपल लें और निरीक्षण करें, प्रोडक्शन में कुछ भेजने से पहले
webhooks boring होने चाहिए। SimplyPrint तीन tools देता है: received payload inspect करें, test fire भेजें और हर past delivery देखें।
टेस्ट इवेंट भेजें
किसी भी सदस्यता से मांग पर वास्तविक संरचना वाला डेटा भेजें।
नमूना पेलोड
code लिखने से पहले exact payload format देखें।
डिलीवरी इतिहास
हर delivery का URL, HTTP status, response body और timestamp।
डिलीवर होने पर आपके webhooks कैसे दिखते हैं
Discord, Slack और Teams फ़ॉर्मैट उन ऐप्स में नेटिव एम्बेड कार्ड की तरह दिखाई देते हैं, जिनमें समृद्ध शीर्षक, फ़ील्ड वाला payload और वैकल्पिक प्रिंटर thumbnail हो सकता है। यहाँ SimplyPrint चला रहे एक print farm से सीधे Discord channel में कैप्चर की गई तीन वास्तविक deliveries हैं। फ़ॉर्मैट एक बार configure करें; एम्बेड SimplyPrint संभालता है।
मेंटेनेंस की समय-सीमा बीत चुकी है
निर्धारित मेंटेनेंस कार्य आदेश अपनी नियत तिथि से चूक गया: जॉब का नाम, प्रिंटर, प्राथमिकता, schedule और समूह, सभी एक कार्ड में।
मेंटेनेंस जॉब बनाई गई
नया मेंटेनेंस कार्य आदेश निर्धारित हुआ: प्रिंटर, समूह और प्राथमिकता तुरंत आपकी टीम के चैनल में दिखते हैं।
स्पेयर पार्ट्स इन्वेंट्री
इन्वेंटरी में बदलाव, पार्ट हटाए गए, स्टॉक समायोजित किया गया या रीस्टॉक किया गया, अलग-अलग इवेंट के रूप में भेजे जाते हैं ताकि workflow टूल हर बदलाव पर प्रतिक्रिया दे सके।
वैकल्पिक गुप्त सत्यापन, साबित करें कि अनुरोध वास्तव में SimplyPrint से आया है
हर webhook के लिए अलग secret सेट करें और SimplyPrint उसे हर डिलीवरी में X-SP-Secret header के साथ भेजता है, ताकि आपका रिसीवर जाँच सके कि अनुरोध वास्तव में हमसे आया है, न कि किसी रैंडम IP से जिसने आपके URL का अनुमान लगाया हो। आंतरिक नेटवर्क webhooks पर secret छोड़ दें, जहाँ इसकी आवश्यकता न हो। key लीक होने पर उसे बदलें, पिछली deliveries अमान्य नहीं होतीं, आगे की deliveries नई key का उपयोग करती हैं।
हर webhook को अलग से भी सक्षम / अक्षम किया जा सकता है, इसका event subscription या history खोए बिना किसी शोर वाले integration को रोकने के लिए टॉगल बदलें।
लोग वास्तव में क्या जोड़ते हैं
ये वे patterns हैं जो हमें SimplyPrint चलाने वाले print farms, schools, makerspaces और product teams में सबसे अधिक दिखते हैं।
अपने टीम चैनल पर job.done और job.failed पोस्ट करें।
कतार आइटम मंज़ूर होने पर इनवॉइस या ऑर्डर पूर्ति ट्रिगर करें।
बकाया मेंटेनेंस या spare-part के कम stock पर ऑप्स टीम को सूचित करें।
छात्र सबमिशन शिक्षकों को रीयल टाइम में दिखाएँ।
पूरे developer workflow का push वाला हिस्सा
Webhooks, SimplyPrint के बाकी डेवलपर टूल्स के साथ स्वाभाविक रूप से जुड़ते हैं:
- SimplyPrint API आपके code को मांग पर कोई भी स्थिति pull करने देता है, प्रिंटर, कतार, फ़ाइलें, filament, जॉब।
- Webhooks बदलाव होते ही SimplyPrint को पुश करने देते हैं, इसलिए आपको पोल नहीं करना पड़ता।
- SimplyPrint MCP server AI assistants (Claude, ChatGPT) को सत्यापित tool registry के जरिए उसी फ़्लीट को पढ़ने और उस पर कार्रवाई करने देता है।
प्लान एक्सेस: webhooks किन प्लान में शामिल हैं?
Webhooks Print Farm और Enterprise प्लान में बिना किसी अतिरिक्त लागत के शामिल हैं। हर webhook के लिए कोई शुल्क नहीं, हर डिलीवरी के लिए कोई शुल्क नहीं, और इवेंट की कोई सीमा नहीं।
| सुविधा / सीमा | मुफ़्त | Basic | प्रो | प्रिंट फार्म | एंटरप्राइज़ | स्कूल | Cloud Slicer | फिलामेंट मैनेजर |
|---|---|---|---|---|---|---|---|---|
|
Webhooks
पूरा multi-channel webhook system: regular JSON, Discord, Slack और Microsoft Teams, पूरे event catalog, optional secret verification और हर delivery के इतिहास सहित।
|
क्या आप हमारी योजनाओं के बारे में और जानना चाहते हैं?
पूरी कीमत और सुविधाओं की तुलना देखेंअक्सर पूछे जाने वाले सवाल
मैं Discord, Slack या Microsoft Teams को events कैसे भेजूँ?
discord.com/api/webhooks, hooks.slack.com/services या Teams workflow URL, और payload उस platform के लिए नेटिव format करते हैं। bot, app या middleware नहीं।किन events को subscribe कर सकता हूँ?
मैं कैसे जाँचूँ कि request सच में SimplyPrint से आई है?
क्या मैं देख सकता हूँ कि क्या डिलीवर हुआ है?
क्या मैं live होने से पहले webhook टेस्ट कर सकता हूँ?
यह SimplyPrint API से कैसे अलग है?
अगर मेरा सर्वर बंद हो, तो दोबारा कोशिशों का क्या होगा?
क्या SimplyPrint विफल deliveries को फिर से भेजने की कोशिश करता है?
डिलीवरी प्रयास कितने समय तक संग्रहीत रहते हैं?
किन plans में webhooks हैं?
चरण-दर-चरण सेटअप गाइड
अपना पहला webhook बनाने की चरण-दर-चरण जानकारी के लिए, Discord, Slack और Microsoft Teams URL की खास जानकारी सहित, पूरा webhooks सहायता लेख देखें।