मुख्य सामग्री पर जाएं
POST
curl
हर कॉल webhook को फिर से डिलीवर करती है। थोक में पुनः भेजने से पहले अपने endpoint को event_id पर आइडेम्पोटेंट बनाएँ, और केवल वही डिलीवरी पुनः भेजें जिनका response_status null, 400 या उससे अधिक है।
पुनः भेजना उसी URL पर जाता है जिसका उपयोग मूल डिलीवरी ने किया था। यदि आपने गंतव्य को नए URL पर स्थानांतरित किया है, तो पुरानी डिलीवरी अब भी पुराने URL की ओर इंगित करती हैं। पुनः भेजी जाने वाली डिलीवरी खोजने के लिए webhook गंतव्य की डिलीवरी सूची प्राप्त करें का उपयोग करें, और हस्ताक्षर सत्यापन के लिए 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 जिस पर डिलीवरी भेजी गई थी।

delivery_uuid
string<uuid>
आवश्यक

पुनः भेजी जाने वाली डिलीवरी का UUID: GET /v3/webhook/destinations/{destination_uuid}/deliveries/ द्वारा लौटाई गई किसी प्रविष्टि का uuid।

प्रतिक्रिया

नई डिलीवरी, जिसका पहले ही प्रयास किया जा चुका है। response_status वह है जो आपके endpoint ने इस बार उत्तर दिया (504 टाइमआउट, 503 कनेक्शन विफलता)। मूल डिलीवरी अपरिवर्तित रहती है।

एक webhook गंतव्य पर एक डिलीवरी प्रयास, सटीक अनुरोध हेडर और मुख्य भाग के साथ जो Didit ने भेजा था।

uuid
string<uuid>
आवश्यक

डिलीवरी ID, विवरण और पुनः भेजने के कॉल के लिए।

session_id
string<uuid> | null
आवश्यक

उपयोगकर्ता सत्यापन सत्र जिससे यह इवेंट संबंधित है। व्यवसाय सत्र, उपयोगकर्ता, व्यवसाय, लेन-देन, Travel Rule और वर्कफ़्लो इवेंट के लिए null।

request_url
string<uri> | null
आवश्यक

वह URL जिस पर डिलीवरी भेजी गई थी: इवेंट जनरेट होने के समय गंतव्य का URL।

response_status
integer | null
आवश्यक

आपके endpoint द्वारा लौटाया गया HTTP स्टेटस। जब डिलीवरी कतार में हो और अभी तक प्रयास न किया गया हो तो null। जब कोई HTTP उत्तर प्राप्त नहीं हुआ, तो Didit अपनी स्वयं की स्थिति दर्ज करता है: जब आपके endpoint ने 5 सेकंड के भीतर उत्तर नहीं दिया तो 504, कनेक्शन विफलता के लिए 503, जब URL को असुरक्षित (उदाहरण के लिए एक निजी या आंतरिक पता) के रूप में अस्वीकार कर दिया गया था तो 400, और किसी भी अन्य अनुरोध त्रुटि के लिए 404। 400 या उससे अधिक को विफल डिलीवरी माना जाता है।

response_time_ms
integer | null
आवश्यक

प्रयास में लगा समय, मिलीसेकंड में। जब तक डिलीवरी कतार में है तब तक null।

आवश्यक सीमा: x >= 0
status
string | null
आवश्यक

इवेंट जनरेट होने पर उसके द्वारा रिपोर्ट किया गया स्टेटस: सत्र इवेंट के लिए सत्र स्टेटस (उदाहरण के लिए Approved या In Review), उपयोगकर्ता और व्यवसाय इवेंट के लिए व्यक्ति या कंपनी का स्टेटस, और लेन-देन इवेंट के लिए लेन-देन का स्टेटस। बिना किसी स्टेटस वाले इवेंट के लिए null।

webhook_type
enum<string>
आवश्यक

समर्थित 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_at
string<date-time>
आवश्यक

जब डिलीवरी बनाई गई थी।

request_header
string
आवश्यक

Didit द्वारा भेजे गए अनुरोध हेडर का JSON टेक्स्ट (एक स्ट्रिंग): Content-Type, X-Signature, X-Signature-V2, X-Signature-Simple, X-Timestamp और User-Agent। इसे JSON पार्सर से पार्स करें। इसमें हस्ताक्षर होते हैं, लेकिन साइनिंग सीक्रेट कभी नहीं होता।

request_body
string
आवश्यक

Didit द्वारा भेजे गए सटीक payload का JSON टेक्स्ट (एक स्ट्रिंग), कुंजियाँ सॉर्ट की गई हैं, जिसमें event_id और timestamp शामिल हैं। इसे JSON पार्सर से पार्स करें; Payload shape देखें। बिना media: read वाली स्कोप्ड कुंजी के लिए, इसके अंदर मीडिया URL null होते हैं; बिना sessions: write के, सत्र token और होस्टेड सत्यापन लिंक null होते हैं। इस तरह बदली गई बॉडी अब अपने हस्ताक्षरों से मेल नहीं खाती है। Didit आपके endpoint द्वारा लौटाए गए रिस्पॉन्स बॉडी को रिकॉर्ड नहीं करता है।

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