शुरू करें
इंटीग्रेट करें / SDK
उपयोगकर्ता सत्यापन
व्यवसाय सत्यापन
लेन-देन निगरानी
चेंजलॉगcurl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/?status=active,in_review&ordering=-risk_score' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
for item in client.networks.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
for await (const item of didit.networks.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
iter := client.Networks.ListAutoPaging(ctx, didit.NetworksListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
for (var item : client.networks().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
foreach ($didit->networks->list() as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
didit.networks.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
await foreach (var item in await client.Networks.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 123,
"next": 123,
"previous": 123,
"results": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"network_id": "<string>",
"name": "<string>",
"status": "active",
"risk": {
"score": 123,
"band": "low",
"bar": 123
},
"pattern_types": [
"exact_same_device"
],
"signal_types": [
"ip_address"
],
"member_counts": {},
"member_status": {},
"signal_coverage": {},
"first_activity_at": "2023-11-07T05:31:56Z",
"last_activity_at": "2023-11-07T05:31:56Z"
}
],
"sharing_mode": "global",
"cross_org_available": true,
"cross_org_unavailable_reason": null,
"kpis": {
"active": {},
"in_review": {},
"applicants_involved": {},
"detected_this_period": {},
"false_positive_rate": {}
},
"counts": {
"scopes": {
"all": 123,
"identity": 123,
"transactions": 123
},
"views": {
"all": 123,
"active": 123,
"in_review": 123,
"resolved": 123,
"dismissed": 123,
"mine": 123,
"high_risk": 123
},
"facets": {
"total": 123,
"last_activity_days": {
"7": 123,
"30": 123,
"90": 123
},
"risk_min": {
"50": 123,
"80": 123
},
"signal_types": {
"ip_address": 123,
"device": 123,
"face": 123,
"document_number": 123,
"phone": 123,
"email": 123,
"address": 123
},
"priority": {
"low": 123,
"medium": 123,
"high": 123,
"none": 123
},
"assignee": {
"me": 123,
"unassigned": 123,
"users": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"full_name": "<string>",
"email": "<string>",
"count": 123
}
]
},
"has_case": 123,
"min_size": {
"10": 123
}
}
}
}फ़्रॉड नेटवर्क सूची API
Didit में आपके संगठन के फ़्रॉड नेटवर्क की सूची पाएँ, स्थिति, सिग्नल, पैटर्न, जोखिम स्तर, आकार और तिथि से फ़िल्टर करें, साझाकरण मोड सहित।
curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/?status=active,in_review&ordering=-risk_score' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
for item in client.networks.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
for await (const item of didit.networks.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
iter := client.Networks.ListAutoPaging(ctx, didit.NetworksListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
for (var item : client.networks().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
foreach ($didit->networks->list() as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
didit.networks.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
await foreach (var item in await client.Networks.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 123,
"next": 123,
"previous": 123,
"results": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"network_id": "<string>",
"name": "<string>",
"status": "active",
"risk": {
"score": 123,
"band": "low",
"bar": 123
},
"pattern_types": [
"exact_same_device"
],
"signal_types": [
"ip_address"
],
"member_counts": {},
"member_status": {},
"signal_coverage": {},
"first_activity_at": "2023-11-07T05:31:56Z",
"last_activity_at": "2023-11-07T05:31:56Z"
}
],
"sharing_mode": "global",
"cross_org_available": true,
"cross_org_unavailable_reason": null,
"kpis": {
"active": {},
"in_review": {},
"applicants_involved": {},
"detected_this_period": {},
"false_positive_rate": {}
},
"counts": {
"scopes": {
"all": 123,
"identity": 123,
"transactions": 123
},
"views": {
"all": 123,
"active": 123,
"in_review": 123,
"resolved": 123,
"dismissed": 123,
"mine": 123,
"high_risk": 123
},
"facets": {
"total": 123,
"last_activity_days": {
"7": 123,
"30": 123,
"90": 123
},
"risk_min": {
"50": 123,
"80": 123
},
"signal_types": {
"ip_address": 123,
"device": 123,
"face": 123,
"document_number": 123,
"phone": 123,
"email": 123,
"address": 123
},
"priority": {
"low": 123,
"medium": 123,
"high": 123,
"none": 123
},
"assignee": {
"me": 123,
"unassigned": 123,
"users": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"full_name": "<string>",
"email": "<string>",
"count": 123
}
]
},
"has_case": 123,
"min_size": {
"10": 123
}
}
}
}q खोज और वही स्थिति, सिग्नल, पैटर्न और जोखिम-बैंड चिप्स शामिल हैं। assignee, priority, risk_min और has_case पैरामीटर उन असाइनी, प्राथमिकता, न्यूनतम जोखिम और जुड़े केस विकल्पों से मेल खाते हैं जिन्हें counts.facets गिनता है। assignee=me के लिए कंसोल सदस्य token चाहिए; API कुंजी के साथ यह 400 लौटाता है।
साझाकरण मोड और संगठनों के बीच सिग्नल
हर रिस्पॉन्स में आपके संगठन काsharing_mode, cross_org_available और cross_org_unavailable_reason शामिल होता है।
| फ़ील्ड | अर्थ |
|---|---|
sharing_mode | संगठन का संगठनों के बीच साझाकरण मोड। केवल global नेटवर्क की तुलना संगठनों के बीच करता है; private और off नेटवर्क को संगठन के अपने इतिहास तक सीमित रखते हैं। |
cross_org_available | क्या संगठनों के बीच के सिग्नल आपके संगठन पर लागू होते हैं। इसके लिए Enterprise प्लान और global साझाकरण मोड, दोनों चाहिए। |
cross_org_unavailable_reason | plan जब आपका प्लान संगठनों के बीच का धोखाधड़ी नेटवर्क शामिल नहीं करता (इसके लिए Enterprise प्लान चाहिए), आपके साझाकरण मोड की परवाह किए बिना। sharing_mode जब प्लान इसे शामिल करता है लेकिन आपका साझाकरण मोड private या off है। null जब cross_org_available true है। |
plan होता है, भले ही आपका साझाकरण मोड global हो।
गिनती और summary पैरामीटर
kpis आपके फ़िल्टर से मेल खाने वाले नेटवर्क को एकत्र करते हैं, और counts आपके एप्लिकेशन को दिखने वाले हर नेटवर्क को एकत्र करता है, इसलिए दोनों की लागत केवल पेज की लागत से अधिक होती है।
केवल पेज और उसका count चाहिए हो, तो summary=false पास करें: तब रिस्पॉन्स में kpis और counts शामिल नहीं होते।
summary केवल true या false स्वीकार करता है; कोई और मान 400 लौटाता है।
counts में सूची के व्यू और फ़िल्टर विकल्पों के पीछे की संख्याएँ होती हैं, और हर नेटवर्क एक बार गिना जाता है:
| कुंजी | क्या गिनता है |
|---|---|
scopes | हर दिखने वाला नेटवर्क (all), जो transactions (जिसका हर सदस्य लेन-देन पक्ष है) और identity (बाकी हर नेटवर्क) में बँटा है। |
views | चुने गए scope (all) के भीतर दिखने वाले नेटवर्क, स्थिति के अनुसार (active, in_review, resolved, dismissed), कॉल करने वाले कंसोल सदस्य को सौंपे गए (mine), और high_risk (जिनका जोखिम स्कोर 80 या उससे अधिक हो और जो खारिज न किए गए हों)। |
facets | चुने गए scope और status व्यू के नेटवर्क (total), हालिया गतिविधि के अनुसार (last_activity_days: 7, 30, 90), न्यूनतम जोखिम (risk_min: 50, 80), सिग्नल प्रकार, प्राथमिकता (none सहित), असाइनी (me, unassigned, और users में हर असाइनी के लिए एक प्रविष्टि), वे नेटवर्क जिनके लिए आपके एप्लिकेशन ने केस खोला है (has_case), और वे नेटवर्क जिनमें कम से कम 10 सदस्य हैं (min_size)। |
scope और status के अलावा अन्य फ़िल्टर counts को नहीं बदलते।
API कुंजी के लिए views.mine और facets.assignee.me हमेशा 0 होते हैं, क्योंकि कोई कंसोल सदस्य कॉल नहीं कर रहा होता।
एक्सेस
नेटवर्क एंडपॉइंट के लिए पूर्ण-एक्सेस API कुंजी चाहिए। प्रतिबंधित एक्सेस वाली कुंजी को403 मिलता है।
कंसोल सदस्य token को list:networks चाहिए।
जब आपके संगठन के लिए Networks सक्षम नहीं होता, तो हर Networks एंडपॉइंट "code": "networks_not_entitled" के साथ 403 लौटाता है।
संबंधित
प्राधिकरण
आपकी एप्लिकेशन की 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।
पथ पैरामीटर
संगठन UUID।
एप्लिकेशन UUID।
क्वेरी पैरामीटर
शामिल करने के लिए स्थितियों की अल्पविराम से अलग की गई सूची: active,in_review,resolved,dismissed। dismissed को बाहर करने के लिए छोड़ दें।
transactions उन नेटवर्कों को रखता है जिनके सदस्य सभी लेन-देन पक्ष हैं; identity अन्य प्रत्येक नेटवर्क को रखता है। दोनों के लिए छोड़ दें। यह counts.views और counts.facets को भी सीमित करता है। कोई भी अन्य मान 400 लौटाता है।
identity, transactions अल्पविराम से अलग किए गए सिग्नल प्रकार: ip_address,device,face,document_number,phone,email,address।
अल्पविराम से अलग किए गए पैटर्न प्रकार, उदाहरण के लिए exact_same_device,same_email।
कॉमा से अलग किए गए बैंड: low,medium,high।
न्यूनतम सदस्य संख्या।
अधिकतम सदस्य संख्या।
कॉमा से अलग किए गए असाइनी: unassigned, सदस्य ईमेल (केस-असंवेदनशील मिलान), या कॉलिंग कंसोल सदस्य के लिए me। एक नेटवर्क किसी भी मान से मेल खाता है। me के लिए कंसोल सदस्य token आवश्यक है: API कुंजी को 400 {"assignee": ["\"me\" needs a user token; an API key has no assignee identity."]} प्राप्त होता है।
अल्पविराम से अलग की गई प्राथमिकताएँ: बिना किसी प्राथमिकता वाले नेटवर्क के लिए low, medium, high, या none। कोई अन्य मान 400 {"priority": "Unknown priority: <values>."} लौटाता है।
न्यूनतम जोखिम स्कोर, 0 से 100 तक की एक पूर्ण संख्या। ऐसा मान जो पूर्ण संख्या नहीं है, 400 {"risk_min": "Use a whole number from 0 to 100."} लौटाता है।
0 <= x <= 100true उन नेटवर्क को रखता है जिनके लिए आपके एप्लिकेशन ने एक केस खोला है, false दूसरों को रखता है। किसी भी अन्य मान को अनदेखा कर दिया जाता है।
last_activity_at पर निचली सीमा (ISO 8601 तिथि या दिनांक-समय)।
first_activity_at पर ऊपरी सीमा (ISO 8601 दिनांक या डेटटाइम)।
नेटवर्क नाम, सदस्य नामों, network_id (N-0001), और सटीक pattern_type टोकनों में मुक्त-पाठ खोज।
risk_score, -risk_score, last_activity_at, -last_activity_at, first_activity_at, -first_activity_at, network_number, -network_number में से एक। डिफ़ॉल्ट रूप से -risk_score,-last_activity_at है।
पेज का आकार, 1-500। डिफ़ॉल्ट 100 है।
1 <= x <= 500पहले रिकॉर्ड का शून्य-आधारित ऑफ़सेट।
x >= 0false केवल पेज और उसकी count लौटाता है, बिना kpis और counts के। डिफ़ॉल्ट रूप से true। true या false के अलावा कोई भी मान 400 लौटाता है।
प्रतिक्रिया
पेजिनेटेड नेटवर्क सूची, संगठन के शेयरिंग मोड और क्रॉस-ऑर्गनाइज़ेशन उपलब्धता के साथ, साथ ही kpis और counts जब तक कि summary=false न हो।
अगले पेज का ऑफ़सेट, या अंतिम पेज पर null।
Show child attributes
Show child attributes
संगठन का क्रॉस-संगठन शेयरिंग मोड। केवल global ही विभिन्न संगठनों के नेटवर्क की तुलना करता है; private और off उन्हें संगठन के अपने इतिहास तक ही सीमित रखते हैं।
off, private, global "global"
क्या क्रॉस-संगठन संकेत इस संगठन पर लागू होते हैं। उन्हें Enterprise प्लान और global शेयरिंग मोड दोनों की आवश्यकता होती है।
true
क्रॉस-ऑर्गेनाइज़ेशन सिग्नल क्यों लागू नहीं होते, इस क्रम में जाँचे जाते हैं। plan: संगठन के प्लान में क्रॉस-ऑर्गेनाइज़ेशन फ़्रॉड नेटवर्क शामिल नहीं है (इसके लिए Enterprise प्लान की आवश्यकता है), भले ही शेयरिंग मोड कुछ भी हो। sharing_mode: प्लान में यह शामिल है, लेकिन शेयरिंग मोड private या off है। cross_org_available के true होने पर Null।
plan, sharing_mode null
प्रत्येक कुंजी वर्तमान फ़िल्टर से मेल खाने वाले परिणामों के लिए {value, delta} है। summary=false होने पर छोड़ दी जाती है।
Show child attributes
Show child attributes
सूची के दृश्यों और फ़िल्टर विकल्पों के लिए नेटवर्क संख्या, प्रत्येक नेटवर्क की एक बार गणना की गई है। केवल तभी लौटाया जाता है जब summary false न हो। scopes एप्लिकेशन को दिखाई देने वाले प्रत्येक नेटवर्क की गणना करता है। views चयनित scope के अंदर दिखाई देने वाले नेटवर्क की गणना करता है। facets चयनित scope और status दृश्य में नेटवर्क की गणना करता है (खारिज किए गए नेटवर्क तब तक छोड़ दिए जाते हैं जब तक कि status में वे शामिल न हों)। अन्य सूची फ़िल्टर इन गणनाओं को नहीं बदलते हैं।
Show child attributes
Show child attributes