Mulai
Integrasi / SDK
Verifikasi Pengguna
Verifikasi Bisnis
Pemantauan Transaksi
Log Perubahancurl -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 Daftar Jaringan Penipuan
Daftar jaringan penipuan yang terdeteksi di organisasi Anda di Didit, difilter menurut status, sinyal, pola, tingkat risiko, ukuran, dan tanggal.
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 serta chip status, sinyal, pola, dan rentang risiko yang sama.
Parameter assignee, priority, risk_min dan has_case sesuai dengan opsi penanggung jawab, prioritas, risiko minimum, dan kasus tertaut yang dihitung oleh counts.facets.
assignee=me memerlukan token anggota konsol; dengan kunci API, respons berupa 400.
Mode berbagi dan sinyal lintas organisasi
Setiap respons menyertakansharing_mode, cross_org_available, dan cross_org_unavailable_reason milik organisasi Anda.
| Kolom | Arti |
|---|---|
sharing_mode | Mode berbagi lintas organisasi milik organisasi. Hanya global yang membandingkan jaringan antarorganisasi; private dan off membatasi jaringan hanya pada riwayat organisasi itu sendiri. |
cross_org_available | Apakah sinyal lintas organisasi berlaku untuk organisasi Anda. Sinyal ini memerlukan paket Enterprise sekaligus mode berbagi global. |
cross_org_unavailable_reason | plan ketika paket Anda tidak menyertakan jaringan penipuan lintas organisasi (memerlukan paket Enterprise), apa pun mode berbagi Anda. sharing_mode ketika paket menyertakannya tetapi mode berbagi Anda private atau off. null ketika cross_org_available bernilai true. |
plan meskipun mode berbagi Anda global.
Jumlah dan parameter summary
kpis mengagregasi jaringan yang cocok dengan filter Anda, dan counts mengagregasi setiap jaringan yang dapat dilihat aplikasi Anda, sehingga keduanya memerlukan biaya lebih besar daripada halaman itu sendiri.
Kirim summary=false jika Anda hanya memerlukan halaman dan count-nya: respons kemudian tidak menyertakan kpis dan counts.
summary hanya menerima true atau false; nilai lain mengembalikan 400.
counts berisi angka di balik tampilan dan opsi filter daftar, dengan setiap jaringan dihitung satu kali:
| Kunci | Yang dihitung |
|---|---|
scopes | Setiap jaringan yang terlihat (all), dibagi menjadi transactions (setiap anggota adalah pihak transaksi) dan identity (setiap jaringan lainnya). |
views | Jaringan yang terlihat di dalam scope yang dipilih (all), berdasarkan status (active, in_review, resolved, dismissed), yang ditugaskan kepada anggota konsol yang memanggil (mine), dan high_risk (skor risiko 80 atau lebih, tidak berstatus dismissed). |
facets | Jaringan dalam scope dan tampilan status yang dipilih (total), berdasarkan aktivitas terbaru (last_activity_days: 7, 30, 90), risiko minimum (risk_min: 50, 80), jenis sinyal, prioritas (termasuk none), penanggung jawab (me, unassigned, dan satu entri untuk setiap penanggung jawab di users), jaringan yang aplikasi Anda buatkan kasusnya (has_case), dan jaringan dengan minimal 10 anggota (min_size). |
scope dan status tidak mengubah counts.
views.mine dan facets.assignee.me selalu 0 untuk kunci API, karena tidak ada anggota konsol yang memanggil.
Akses
Endpoint jaringan memerlukan kunci API dengan akses penuh. Kunci dengan akses terbatas menerima403.
Token anggota konsol memerlukan list:networks.
Ketika Jaringan tidak diaktifkan untuk organisasi Anda, setiap endpoint jaringan mengembalikan 403 dengan "code": "networks_not_entitled".
Terkait
Otorisasi
Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.
Parameter Path
UUID organisasi.
UUID aplikasi.
Parameter Query
Status yang dipisahkan dengan koma untuk disertakan: active,in_review,resolved,dismissed. Jangan sertakan untuk mengecualikan dismissed.
transactions mempertahankan jaringan yang semua anggotanya adalah pihak transaksi; identity mempertahankan semua jaringan lainnya. Jangan sertakan untuk keduanya. Ini juga mempersempit counts.views dan counts.facets. Nilai lainnya akan mengembalikan 400.
identity, transactions Jenis sinyal yang dipisahkan dengan koma: ip_address,device,face,document_number,phone,email,address.
Jenis pola yang dipisahkan dengan koma, misalnya exact_same_device,same_email.
Rentang yang dipisahkan koma: low,medium,high.
Jumlah anggota minimum.
Jumlah anggota maksimum.
Penerima tugas yang dipisahkan koma: unassigned, email anggota (pencocokan tidak peka huruf besar/kecil), atau me untuk anggota konsol pemanggil. Jaringan cocok dengan nilai apa pun. me memerlukan token anggota konsol: kunci API menghasilkan 400 {"assignee": ["\"me\" needs a user token; an API key has no assignee identity."]}.
Prioritas yang dipisahkan dengan koma: low, medium, high, atau none untuk jaringan tanpa prioritas. Nilai lainnya mengembalikan 400 {"priority": "Unknown priority: <values>."}.
Skor risiko minimum, bilangan bulat dari 0 hingga 100. Nilai yang bukan bilangan bulat mengembalikan 400 {"risk_min": "Use a whole number from 0 to 100."}.
0 <= x <= 100true mempertahankan jaringan tempat aplikasi Anda membuka kasus, false untuk yang lainnya. Nilai lainnya akan diabaikan.
Batas bawah pada last_activity_at (tanggal atau tanggal-waktu ISO 8601).
Batas atas untuk first_activity_at (tanggal atau datetime ISO 8601).
Pencarian teks bebas di seluruh nama jaringan, nama anggota, network_id (N-0001), dan token pattern_type yang tepat.
Salah satu dari risk_score, -risk_score, last_activity_at, -last_activity_at, first_activity_at, -first_activity_at, network_number, -network_number. Defaultnya adalah -risk_score,-last_activity_at.
Ukuran halaman, 1-500. Nilai default-nya 100.
1 <= x <= 500Offset berbasis nol dari rekaman pertama.
x >= 0false hanya mengembalikan halaman beserta count-nya, tanpa kpis dan counts. Default-nya adalah true. Nilai apa pun selain true atau false akan mengembalikan 400.
Respons
Daftar jaringan berpaginasi, dengan mode berbagi organisasi dan ketersediaan lintas organisasi, ditambah kpis dan counts kecuali jika summary=false.
Offset halaman berikutnya, atau null pada halaman terakhir.
Show child attributes
Show child attributes
Mode berbagi lintas-organisasi milik organisasi. Hanya global yang membandingkan jaringan di seluruh organisasi; private dan off membatasinya hanya pada riwayat organisasi itu sendiri.
off, private, global "global"
Menentukan apakah sinyal lintas organisasi berlaku untuk organisasi ini. Fitur ini memerlukan paket Enterprise dan mode berbagi global.
true
Alasan mengapa sinyal lintas organisasi tidak berlaku, diperiksa dalam urutan ini. plan: paket organisasi tidak mencakup jaringan penipuan lintas organisasi (memerlukan paket Enterprise), apa pun mode berbaginya. sharing_mode: paket mencakupnya, tetapi mode berbagi adalah private atau off. Null jika cross_org_available bernilai true.
plan, sharing_mode null
Setiap kunci adalah {value, delta} atas hasil yang cocok dengan filter saat ini. Dihilangkan saat summary=false.
Show child attributes
Show child attributes
Jumlah jaringan untuk tampilan dan opsi filter daftar, setiap jaringan dihitung sekali. Hanya dikembalikan jika summary bukan false. scopes menghitung setiap jaringan yang terlihat oleh aplikasi. views menghitung jaringan yang terlihat di dalam scope yang dipilih. facets menghitung jaringan di dalam scope yang dipilih dan tampilan status yang dipilih (jaringan yang diabaikan tidak disertakan kecuali status menyertakannya). Filter daftar lainnya tidak mengubah jumlah ini.
Show child attributes
Show child attributes