मुख्य सामग्री पर जाएं

Webhooks और Events

Markdown

webhook एक प्रणालीगत अधिसूचना सेवा है जो सिस्टमों के बीच असिंक्रोनस इंटीग्रेशन को सक्षम बनाती है — Unico IDCloud आपके बैकएंड को तब सूचित करता है जब कोई प्रक्रिया स्थिति बदलती है, ताकि आपको अपडेट के लिए polling न करनी पड़े।

यह अनुभाग webhook इंटीग्रेट करने के लिए आवश्यक चार चीजें कवर करता है: endpoint और प्रमाणीकरण सेटअप कैसे करें, Unico जो events भेजता है, fallback रणनीति, और आपके endpoint को लागू करने वाले सुरक्षा और विश्वसनीयता पैटर्न।

Webhooks का उपयोग कब करें​

प्रक्रिया पूरी होने की सूचना पाने का अनुशंसित तरीका Webhooks है। ये विशेष रूप से इनके लिए प्रासंगिक हैं:

  • Human Token Journey (humantoken, humantoken+revalidation) — जब उपयोगकर्ता प्रोसेस बनाएं से बनाई गई प्रक्रिया की यात्रा पूरी करता है, तब सूचना पाने के लिए। Webhooks केवल अंतिम स्थिति (PROCESS_STATE_FINISHED) पर ट्रिगर होते हैं; कोई मध्यवर्ती प्रगति इवेंट नहीं भेजा जाता।
  • API Only फ़्लो (api+humantoken, api+liveness+humantoken, api+liveness+humantoken+revalidation) — परिणाम पहले से ही प्रोसेस बनाएं के response में आता है, इसलिए ये फ़्लो webhook पर निर्भर नहीं हैं।

Webhooks GetProcess endpoints को पूरक बनाते हैं, लेकिन प्रतिस्थापित नहीं करते। Fallback देखें।

इस अनुभाग में​

  • Setup — endpoint पंजीकरण, प्रमाणीकरण विधियाँ (OAuth2, Basic, API Key), retry सेटिंग।
  • Event प्रकार — Unico जो events भेजता है और पेलोड संरचना।
  • सुरक्षा — idempotency, concurrency limit और error rate।
  • Fallback — webhook अनुपलब्ध होने पर प्रक्रिया परिणाम कैसे प्राप्त करें।
अंतिम अपडेट को