मुख्य सामग्री पर जाएं
PATCH
curl
इस endpoint का उपयोग करके आप बदल सकते हैं कि webhook गंतव्य webhooks कहाँ भेजे और उसे कौन-से इवेंट मिलते हैं।

subscribed_events को अपडेट करना

जब आप subscribed_events भेजते हैं, तो अपडेट के बाद सदस्यता में बने रहने वाले इवेंट की पूरी सूची दें। ऐरे पिछले सदस्यता सेट की जगह ले लेता है।
समर्थित मान ये हैं: इन्वेस्टिगेटर (investigator.*) और प्रमाणीकरण (auth.*) इवेंट समूह भी स्वीकार किए जाते हैं। पूरी सूची के लिए Webhooks देखें। इवेंट के विस्तृत विवरण और सामान्य सदस्यता सेट के लिए गंतव्य बनाने की गाइड देखें।

प्राधिकरण

x-api-key
string
header
आवश्यक

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।

पथ पैरामीटर

destination_uuid
string<uuid>
आवश्यक

अपडेट किए जाने वाले गंतव्य का UUID।

बॉडी

application/json
label
string

नया मानव-पठनीय नाम।

url
string<uri>

नया लक्ष्य URL। एप्लिकेशन के भीतर अद्वितीय होना चाहिए।

enabled
boolean

इस गंतव्य को हटाए बिना इस पर डिलीवरी रोकने के लिए false पर सेट करें।

webhook_version
enum<string>

भविष्य की डिलीवरी के लिए नया payload स्कीमा संस्करण।

उपलब्ध विकल्प:
v1,
v2,
v3
subscribed_events
enum<string>[]

इस webhook गंतव्य के लिए इवेंट फ़िल्टर। Didit केवल उन webhook को डिलीवर करता है जिनका इवेंट प्रकार इनमें से किसी एक मान से सटीक रूप से मेल खाता है — कोई वाइल्डकार्ड सब्सक्रिप्शन नहीं है। भेजे जाने पर, सूची में कम से कम एक मान्य इवेंट होना चाहिए (एक स्पष्ट [] को 400 के साथ अस्वीकार कर दिया जाता है); ऐसा गंतव्य जिसकी सूची खाली है (निर्माण के समय फ़ील्ड छोड़ दिया गया) कुछ भी प्राप्त नहीं करता है। अपडेट करने पर सूची पूरी तरह से बदल दी जाती है, कभी मर्ज नहीं की जाती।

Minimum array length: 1

समर्थित webhook इवेंट का नाम। subscribed_events में इन सटीक स्ट्रिंग्स का उपयोग करें; असमर्थित मान अस्वीकृत कर दिए जाते हैं।

उपलब्ध विकल्प:
status.updated,
data.updated,
user.status.updated,
user.data.updated,
business.status.updated,
business.data.updated,
activity.created,
transaction.created,
transaction.status.updated,
travel_rule.status.updated,
workflow.compliance_changed,
transaction_rule_suggestions.created,
auth.signup,
auth.login,
auth.login_failed,
auth.password_reset_requested,
auth.password_reset_completed,
auth.mfa_changed,
auth.new_device,
auth.account_locked,
investigator.report.ready,
investigator.decision.automated,
investigator.decision.overridden,
investigator.decision.contested,
investigator.question.raised,
investigator.automation.paused,
investigator.rfi.answered,
investigator.rfi.overdue,
investigator.drift.detected,
investigator.sla.breached,
investigator.qa.failed,
investigator.external.report.ready
उदाहरण:

प्रतिक्रिया

अपडेट किया गया webhook गंतव्य। बॉडी का स्वरूप GET /v3/webhook/destinations/{destination_uuid}/ के समान है।

uuid
string<uuid>
label
string
url
string<uri>
enabled
boolean
webhook_version
enum<string>
उपलब्ध विकल्प:
v1,
v2,
v3
secret_shared_key
string
secret_last4
string

गंतव्य के वर्तमान साइनिंग सीक्रेट के अंतिम चार वर्ण, ताकि आप सीक्रेट में अंतर कर सकें। हस्ताक्षर सत्यापित करने के लिए पर्याप्त नहीं है।

previous_secret_expires_at
string<date-time> | null

Business Console में गंतव्य के साइनिंग सीक्रेट को रोटेट किए जाने के बाद 24 घंटों के लिए सेट होता है। इस समय तक, गंतव्य पर प्रत्येक डिलीवरी में बदले गए सीक्रेट के साथ बनाए गए X-Signature-Previous, X-Signature-V2-Previous और X-Signature-Simple-Previous भी शामिल होते हैं (हस्ताक्षर सत्यापन देखें)। पिछले 24 घंटों में कोई रोटेशन न होने पर null।

subscribed_events
enum<string>[]

इस webhook गंतव्य के लिए इवेंट फ़िल्टर। Didit केवल उन webhook को डिलीवर करता है जिनका इवेंट प्रकार इनमें से किसी एक मान से सटीक रूप से मेल खाता है — कोई वाइल्डकार्ड सब्सक्रिप्शन नहीं है। भेजे जाने पर, सूची में कम से कम एक मान्य इवेंट होना चाहिए (एक स्पष्ट [] को 400 के साथ अस्वीकार कर दिया जाता है); ऐसा गंतव्य जिसकी सूची खाली है (निर्माण के समय फ़ील्ड छोड़ दिया गया) कुछ भी प्राप्त नहीं करता है। अपडेट करने पर सूची पूरी तरह से बदल दी जाती है, कभी मर्ज नहीं की जाती।

Minimum array length: 1

समर्थित webhook इवेंट का नाम। subscribed_events में इन सटीक स्ट्रिंग्स का उपयोग करें; असमर्थित मान अस्वीकृत कर दिए जाते हैं।

उपलब्ध विकल्प:
status.updated,
data.updated,
user.status.updated,
user.data.updated,
business.status.updated,
business.data.updated,
activity.created,
transaction.created,
transaction.status.updated,
travel_rule.status.updated,
workflow.compliance_changed,
transaction_rule_suggestions.created,
auth.signup,
auth.login,
auth.login_failed,
auth.password_reset_requested,
auth.password_reset_completed,
auth.mfa_changed,
auth.new_device,
auth.account_locked,
investigator.report.ready,
investigator.decision.automated,
investigator.decision.overridden,
investigator.decision.contested,
investigator.question.raised,
investigator.automation.paused,
investigator.rfi.answered,
investigator.rfi.overdue,
investigator.drift.detected,
investigator.sla.breached,
investigator.qa.failed,
investigator.external.report.ready
उदाहरण:
created_by_email
string | null

उस Business Console सदस्य का ईमेल जिसने गंतव्य बनाया। API कुंजी से बनाए गए गंतव्य के लिए null।

created_by_name
string | null

Business Console के उस सदस्य का नाम जिसने गंतव्य बनाया। API कुंजी से बनाए गए गंतव्य के लिए null।

created_at
string<date-time>
updated_at
string<date-time>
health_status
enum<string>

डिलीवरी स्थिति। failing: गंतव्य द्वारा पिछली बार सफलतापूर्वक उत्तर दिए जाने के बाद से 3 या अधिक लगातार इवेंट अपने पहले डिलीवरी प्रयास में विफल रहे (देखें failing_streak)। degraded: failing नहीं है, लेकिन पिछले 24 घंटों में एक डिलीवरी प्रयास विफल रहा और बाद के किसी भी प्रयास ने उस इवेंट को डिलीवर नहीं किया है; इसे डिलीवर करने वाला पुनः प्रयास या पुनः भेजना इसे साफ़ कर देता है। healthy: दोनों में से कोई नहीं। enabled से स्वतंत्र। एक विफल प्रयास वह होता है जिसका उत्तर HTTP 400 या उससे ऊपर के साथ दिया गया हो, या कोई उत्तर न दिया गया हो।

उपलब्ध विकल्प:
healthy,
degraded,
failing
failing_streak
integer

पिछले 30 दिनों के भीतर, गंतव्य द्वारा पिछली बार सफलतापूर्वक उत्तर देने के बाद से कितने लगातार इवेंट अपने पहले डिलीवरी प्रयास में विफल रहे। पुनः प्रयासों की गणना नहीं की जाती है, और पुनः प्रयास या पुनः भेजने सहित कोई भी सफल प्रयास इस सिलसिले को समाप्त कर देता है। पिछली सफलता के बाद से किसी भी इवेंट के विफल न होने पर 0।

failing_since
string<date-time> | null

जब वर्तमान failing_streak का पहला विफल प्रयास किया गया था। null जब failing_streak 0 हो।

last_success_at
string<date-time> | null

जब गंतव्य ने पिछले 30 दिनों के भीतर, 400 से कम के HTTP स्थिति कोड के साथ डिलीवरी का अंतिम बार उत्तर दिया। null यदि उसने उस अवधि में उत्तर नहीं दिया है।

environment
enum<string>

उस एप्लिकेशन का एनवायरनमेंट जिसके पास गंतव्य का स्वामित्व है।

उपलब्ध विकल्प:
live,
sandbox
summary
object

पिछले metrics_window_days (30) दिनों के लिए डिलीवरी मेट्रिक्स। last_delivery_at सबसे हालिया प्रयास है, चाहे वह कभी भी किया गया हो।

अंतिम संशोधन 7 नवंबर 2026