मुख्य सामग्री पर जाएं
POST
curl
POST /v3/ip/risk/ का उपयोग तब करें जब आपके बैकएंड के पास पहले से IP पता हो और आपको सर्वर-से-सर्वर जोखिम निर्णय चाहिए। रिस्पॉन्स में जियोलोकेशन, नेटवर्क स्वामित्व, VPN/Tor और डेटा-सेंटर फ़्लैग, थ्रेट डेटा शामिल होते हैं, और जब आप दावा किया गया देश भेजते हैं तो country_mismatch भी शामिल होता है।

रिस्पॉन्स की व्याख्या करें

  • status का मान In Review होता है जब हल किया गया देश claimed_country से मेल नहीं खाता, या जब पता VPN, Tor या डेटा-सेंटर इन्फ़्रास्ट्रक्चर से जुड़ा हो। अन्यथा इसका मान Approved होता है।
  • ip.ip_country_code में हल किया गया देश कोड होता है। देशों की तुलना कच्चे स्ट्रिंग मानों से स्वयं करने के बजाय ip.country_mismatch के माध्यम से करें।
  • ip.latitude और ip.longitude अनुमानित नेटवर्क जियोलोकेशन हैं, डिवाइस का सटीक स्थान नहीं।
  • ip.is_vpn_or_tor, ip.is_data_center, ip.proxy_type और ip.threat नेटवर्क-जोखिम के साक्ष्य देते हैं।
  • ip.asn_number, ip.asn_organization, ip.connection_type और ip.carrier उस नेटवर्क का वर्णन करते हैं जिससे पता जुड़ा है।
  • request_id API सत्र आईडी है। यदि आपको परिणाम को बाद के webhooks या कंसोल गतिविधि से जोड़ना है, तो इसे vendor_data के साथ संग्रहीत करें।
IP एनरिचमेंट सर्वोत्तम प्रयास पर आधारित है। यदि कोई भी एनरिचमेंट स्रोत उपयोगी डेटा नहीं लौटाता, तो endpoint ip.ip_address: null, ip.country_mismatch: null और खाली ip.threat ऑब्जेक्ट के साथ एक स्वीकृत रिस्पॉन्स लौटाता है। व्यक्तिगत एनरिचमेंट फ़ील्ड भी अनुपलब्ध होने पर null हो सकते हैं।

डिवाइस इंटेलिजेंस

IP Risk API एक विशुद्ध सर्वर-से-सर्वर endpoint है। डिवाइस फ़िंगरप्रिंटिंग विशुद्ध सर्वर-से-सर्वर endpoint नहीं है, क्योंकि कोई बैकएंड अकेले ब्राउज़र या डिवाइस सिग्नल नहीं देख सकता। होस्टेड फ़्लो और SDK सत्रों के लिए, Didit सत्र के रिस्पॉन्स में पहले से एकत्र किए गए डिवाइस फ़ील्ड उपलब्ध कराता है, जिनमें device_fingerprint, डिवाइस और ब्राउज़र का विवरण, user_agent, कच्चा डिवाइस डेटा और क्रॉस-सत्र मिलान शामिल हैं।

सैंडबॉक्स व्यवहार

सैंडबॉक्स कुंजियाँ अनुरोध को सत्यापित करती हैं और नियतात्मक, स्वीकृत डेटा लौटाती हैं। वे बाहरी इंटेलिजेंस सेवाओं से संपर्क नहीं करतीं, क्रेडिट खर्च नहीं करतीं, कोई सत्र नहीं बनातीं, और Networks में योगदान नहीं देतीं।

बिलिंग

IP Risk API कॉल की लागत सूची मूल्य पर $0.02 है। लाइव अनुरोध तब बिल योग्य हो जाता है जब लुकअप शुरू होता है।

प्राधिकरण

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।

बॉडी

application/json
ip_address
string<ip>
आवश्यक

स्कोर करने के लिए IPv4 या IPv6 पता।

उदाहरण:

"8.8.8.8"

claimed_country
string

उपयोगकर्ता या सत्र द्वारा दावा किया गया वैकल्पिक ISO 3166-1 alpha-2 या alpha-3 देश। country_mismatch की गणना के लिए उपयोग किया जाता है।

Maximum string length: 3
उदाहरण:

"ESP"

user_agent
string

आपके बैकएंड द्वारा देखा गया यूज़र एजेंट। अनुरोध संदर्भ के रूप में संग्रहीत; यह डिवाइस फ़िंगरप्रिंटिंग प्रदान नहीं करता है।

Maximum string length: 512
vendor_data
string

इस अनुरोध के लिए आपका स्थिर संदर्भ। API सत्र पर संग्रहीत और रिस्पॉन्स में लौटाया गया।

metadata
object | null

आपका गैर-संवेदनशील JSON मेटाडेटा। API सत्र पर संग्रहीत और रिस्पॉन्स में दोहराया गया।

प्रतिक्रिया

जोखिम मूल्यांकन पूरा हो गया। निर्णय के लिए status का निरीक्षण करें; पूर्ण लुकअप के लिए HTTP हमेशा 200 होता है।

request_id
string<uuid>
आवश्यक

इस अनुरोध के लिए बनाए गए API सत्र की Id। यदि आपको बाद के webhook इवेंट या कंसोल गतिविधि के साथ परिणाम को सहसंबंधित करने की आवश्यकता है, तो इसे vendor_data के साथ संग्रहीत करें।

status
enum<string>
आवश्यक

इस API सत्र के लिए निर्णय: नेटवर्क या देश-बेमेल जोखिम पर In Review, अन्यथा Approved।

उपलब्ध विकल्प:
Approved,
In Review
created_at
string<date-time>
आवश्यक

इस रिस्पॉन्स का टाइमस्टैम्प।

vendor_data
string | null

आपके द्वारा भेजे गए vendor_data का इको, जब आपने इसे नहीं भेजा हो तो null।

metadata
object | null

आपके द्वारा भेजे गए metadata का इको, जब आपने इसे नहीं भेजा हो तो null।

ip
object

IP जोखिम परिणाम। अलग-अलग एनरिचमेंट फ़ील्ड null हो सकते हैं जब लुकअप से कोई उपयोगी डेटा न मिला हो।

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