यूनिवर्सल वेबहुक कनेक्टर
किसी भी API को प्रमाणीकृत कॉल, HMAC सत्यापन के साथ इनबाउंड ट्रिगर, और पेजिनेटेड पोलिंग रीड्स — हर 'हम X से इंटीग्रेट करते हैं' के पीछे का कनेक्टर।
यही वह कनेक्टर है जो 'किसी भी टूल' के दावे को ईमानदार बनाता है। आउटबाउंड: basic, OAuth (auto-refresh-and-retry), API-key या bearer auth के साथ प्रति-रिकॉर्ड HTTP कॉल, कस्टम हेडर, JSON या XML बॉडी, प्रति रिकॉर्ड वैकल्पिक JavaScript ट्रांसफ़ॉर्म, और exponential-backoff रीट्राई। इनबाउंड: हर वर्कफ़्लो को secret header से सुरक्षित एक अद्वितीय वेबहुक URL मिलता है, वैकल्पिक GitHub-शैली HMAC सिग्नेचर सत्यापन के साथ। और रीड्स: तीन पेजिनेशन रणनीतियों, cursors और इंक्रीमेंटल since-timestamps वाला एक पोलिंग कनेक्टर जो किसी भी API को शेड्यूल्ड डेटा स्रोत बना देता है।
Workflow ट्रिगर
प्रति वर्कफ़्लो अद्वितीय इनबाउंड URL
secret code हेडर के साथ वर्कफ़्लो के URL पर POST/PUT/DELETE फ़्लो शुरू करता है।
HMAC सिग्नेचर सत्यापन
अपनी कॉल पर हस्ताक्षर करने वाले स्रोतों के लिए वैकल्पिक SHA-256 बॉडी सिग्नेचर (कॉन्फ़िगर योग्य हेडर, GitHub-शैली या raw hex, timing-safe तुलना)।
ड्राफ़्ट टेस्ट कैप्चर
अप्रकाशित वर्कफ़्लो एक नमूना पेलोड कैप्चर करते हैं ताकि डिज़ाइनर लाइव होने से पहले असली डेटा के विरुद्ध फ़ील्ड मैप कर सके।
Workflow एक्शन
कोई भी API कॉल करें
आपके auth मोड, कस्टम हेडर, JSON या XML पेलोड, वैकल्पिक प्रति-रिकॉर्ड JS ट्रांसफ़ॉर्म और backoff के साथ 429/5xx रीट्राई सहित प्रति-रिकॉर्ड HTTP।
OAuth refresh-and-retry
समाप्त टोकन आपके refresh URL के विरुद्ध अपने-आप रिफ्रेश होते हैं और कॉल दोबारा होती है।
डेटा कैसे प्रवाहित होता है
रचना से ही द्विदिशात्मक: HTTP भेज सकने वाला कोई भी सिस्टम आपके वर्कफ़्लो शुरू कर सकता है, और जिस API के विरुद्ध आप प्रमाणीकृत हो सकते हैं उसमें लिखा या उसे पोल किया जा सकता है — पेजिनेशन (Link headers, next-URL पथ, या page params), cursors और आपकी API के अपेक्षित फ़ॉर्मेट में इंक्रीमेंटल since-timestamps के साथ।
कनेक्शन: प्रति workspace संग्रहीत कनेक्शन क्रेडेंशियल्स: basic auth, refresh-token URL के साथ OAuth, कस्टम हेडर के तहत API key, या bearer टोकन।
व्यावहारिक उदाहरण: बिना किसी 'इंटीग्रेशन' के एक आंतरिक टूल
अपनी आंतरिक API के bearer टोकन के साथ एक वेबहुक कनेक्शन बनाएं।
ट्रिगर: योग्य सर्वे प्रतिक्रियाएँ वर्कफ़्लो चलाती हैं।
एक्शन: हर रिकॉर्ड एक छोटे JS ट्रांसफ़ॉर्म से पुनर्आकारित होकर आपके आंतरिक एंडपॉइंट को POST होता है।
एक शेड्यूल्ड रीड उसी API को हर रात बदलावों के लिए पोल करती है, पूरा होने तक पेजिनेट करते हुए।
तैयार flow टेम्पलेट
शिप किया गया टेम्पलेट इंस्टॉल करें और अपनाएँ — शून्य से बनाने की ज़रूरत नहीं।
सेटअप
1.
अपनी API के auth मोड के साथ एक वेबहुक कनेक्शन बनाएं।
2.
इनबाउंड के लिए: वर्कफ़्लो का अद्वितीय URL और secret header स्रोत सिस्टम में कॉपी करें।
3.
रीड्स के लिए: पेजिनेशन और since-पैरामीटर एक बार कॉन्फ़िगर करें; शेड्यूल करें।
अक्सर पूछे जाने वाले प्रश्न
कौन-से auth मोड समर्थित हैं?
Basic auth, स्वचालित refresh-and-retry के साथ OAuth, कस्टम हेडर नाम के तहत API key, और bearer टोकन।
इनबाउंड वेबहुक कैसे सुरक्षित हैं?
हर वर्कफ़्लो के URL को एक secret code हेडर चाहिए, जिसके ऊपर वैकल्पिक HMAC-SHA256 बॉडी सिग्नेचर (कॉन्फ़िगर योग्य हेडर, timing-safe तुलना) भी लगाए जा सकते हैं।
क्या यह APIs को पढ़ भी सकता है, सिर्फ़ कॉल नहीं?
हाँ — पोलिंग कनेक्टर Link-header, next-URL और page/pageSize पेजिनेशन के साथ cursors और इंक्रीमेंटल since-timestamps का समर्थन करता है, जिससे कोई भी API शेड्यूल्ड डेटा स्रोत बन जाती है।