घटनाएँ
| कार्यक्रम | कब भेजा जाता है |
|---|---|
| client.created | कोई ग्राहक जोड़ा जाता है। |
| order.submitted | कोई आवेदन किया जाता है। |
| order.approved | कोई आवेदन अनुमोदित होता है। |
| order.settled | किसी आवेदन का निपटान होता है और अंश जारी किए जाते हैं। |
| distribution.approved | कोई वितरण अनुमोदित होता है। |
| transfer.completed | निवेशकों के बीच कोई हस्तांतरण पूरा होता है। |
| message.received | कोई ग्राहक संदेश भेजता है। |
पेलोड में ID, संख्याएँ और राशियाँ होती हैं, लेकिन कोई व्यक्तिगत डेटा नहीं होता। आपका सिस्टम विवरण API कुंजी से प्राप्त करता है।
एंडपॉइंट जोड़ें
- सेटिंग्स, फिर वेबहुक खोलें, और एंडपॉइंट जोड़ें चुनें।
- एक
httpsपता दर्ज करें जो कुछ ही सेकंड में 2xx स्थिति के साथ उत्तर देता हो। घटनाएँ चुनें। - हस्ताक्षर की गोपनीय कुंजी कॉपी करें। यह केवल एक बार दिखाई जाती है।
- यह जाँचने के लिए कि वह पहुँचती है, परीक्षण घटना भेजें चुनें।
- केवल सार्वजनिक होस्ट पर
httpsपते स्वीकार किए जाते हैं। निजी या आंतरिक नेटवर्क की ओर इशारा करने वाले पते अस्वीकार कर दिए जाते हैं। - रीडायरेक्ट का पालन नहीं किया जाता।
हस्ताक्षर सत्यापित करें
हर डिलीवरी एक JSON POST होती है, जिसमें हेडर EasyHaus-Event, EasyHaus-Delivery और EasyHaus-Signature होते हैं। हस्ताक्षर t=<unix time>,v1=<hex> जैसा दिखता है। अपनी गोपनीय कुंजी से पाठ <t>.<raw body> का HMAC-SHA256 निकालें, उसकी तुलना v1 से करें, और पुराने टाइमस्टैम्प अस्वीकार करें।
बॉडी {id, type, created_at, organization_id, data} होती है।
पुनः प्रयास और बंद होना
- 10 सेकंड के भीतर उत्तर दें। विफल डिलीवरी को बढ़ते अंतराल के साथ अधिकतम 10 प्रयासों तक दोबारा भेजा जाता है।
- लगातार 20 विफलताओं के बाद एंडपॉइंट बंद कर दिया जाता है और स्वामियों तथा व्यवस्थापकों को ईमेल भेजा जाता है। इसे ठीक करें, फिर इसे दोबारा चालू करें, जिससे गिनती शून्य हो जाती है।
- वितरण लॉग हर डिलीवरी, उसकी स्थिति और HTTP कोड दिखाता है, और आपको फिर भेजें की सुविधा देता है।
- आप घटनाएँ संपादित कर सकते हैं, एंडपॉइंट बंद कर सकते हैं, गोपनीय कुंजी बदल सकते हैं (पुरानी कुंजी तुरंत काम करना बंद कर देती है) या उसे हटा सकते हैं।