الحصول على شبكة الاحتيال عبر API

curl

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/' \
  -H 'x-api-key: YOUR_API_KEY'

from didit import Didit

# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()

result = client.networks.retrieve(
    "n3a5e000-0000-4000-8000-000000000001",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();

const result = await didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001");
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()

result, err := client.Networks.Retrieve(ctx, "n3a5e000-0000-4000-8000-000000000001")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();

var result = client.networks().retrieve("n3a5e000-0000-4000-8000-000000000001");
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();

$result = $didit->networks->retrieve('n3a5e000-0000-4000-8000-000000000001');
print_r($result->toArray());

require "didit"

# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new

result = didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001")
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();

var result = await client.Networks.RetrieveAsync("n3a5e000-0000-4000-8000-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "network_id": "N-0042",
  "name": null,
  "status": "in_review",
  "risk": {
    "score": 82,
    "band": "high",
    "bar": 0.82
  },
  "pattern_types": [
    "exact_same_device",
    "same_email"
  ],
  "signal_types": [
    "device",
    "email"
  ],
  "member_counts": {
    "total": 3,
    "users": 3,
    "businesses": 0,
    "transaction_parties": 0
  },
  "member_status": {
    "approved": 1,
    "declined": 1,
    "in_review": 0,
    "not_completed": 1
  },
  "signal_coverage": {
    "device": {
      "signals": 1,
      "subjects": 3,
      "coverage": 1
    },
    "email": {
      "signals": 1,
      "subjects": 2,
      "coverage": 0.6667
    }
  },
  "first_activity_at": "2026-10-01T09:12:44Z",
  "last_activity_at": "2026-10-12T16:03:10Z",
  "stats": {
    "members": {
      "total": 3,
      "users": 3,
      "businesses": 0,
      "transaction_parties": 0
    },
    "member_status": {
      "approved": 1,
      "declined": 1,
      "in_review": 0,
      "not_completed": 1
    },
    "signals": {
      "total": 2,
      "by_type": {
        "device": {
          "signals": 1,
          "subjects": 3,
          "coverage": 1
        },
        "email": {
          "signals": 1,
          "subjects": 2,
          "coverage": 0.6667
        }
      }
    }
  },
  "fraud_tags": [],
  "risk_signals": {
    "residential_proxy_reuse": {
      "detected": false,
      "signal_count": 0,
      "max_subject_count": 0
    },
    "email_intelligence": {
      "enriched_signal_count": 1,
      "high_risk_count": 0,
      "social_profile_count": 0
    },
    "phone_intelligence": {
      "enriched_signal_count": 0,
      "high_risk_count": 0
    }
  },
  "reviewed_at": "2026-10-12T16:30:00Z",
  "reviewed_by": "reviewer@example.com",
  "review_reason": "Shared device across three new accounts.",
  "notes_count": 0,
  "sharing_mode": "global",
  "cross_org_available": true,
  "cross_org_unavailable_reason": null,
  "tags": [
    {
      "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "SUSPICIOUS",
      "color": "#6366F1",
      "source": "custom",
      "added_by": null,
      "added_at": "2026-10-13T08:15:00Z"
    }
  ],
  "outcomes": {
    "approved": 1,
    "declined": 1,
    "in_review": 0,
    "total": 3
  },
  "patterns": [
    {
      "type": "background",
      "score": 0.8125,
      "members": 3,
      "reason": null,
      "computed_at": "2026-10-13T08:00:00Z"
    }
  ]
}

GET

organization

{organization_id}

application

{application_id}

networks

{network_uuid}

curl

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/' \
  -H 'x-api-key: YOUR_API_KEY'

from didit import Didit

# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()

result = client.networks.retrieve(
    "n3a5e000-0000-4000-8000-000000000001",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();

const result = await didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001");
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()

result, err := client.Networks.Retrieve(ctx, "n3a5e000-0000-4000-8000-000000000001")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();

var result = client.networks().retrieve("n3a5e000-0000-4000-8000-000000000001");
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();

$result = $didit->networks->retrieve('n3a5e000-0000-4000-8000-000000000001');
print_r($result->toArray());

require "didit"

# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new

result = didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001")
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();

var result = await client.Networks.RetrieveAsync("n3a5e000-0000-4000-8000-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "network_id": "N-0042",
  "name": null,
  "status": "in_review",
  "risk": {
    "score": 82,
    "band": "high",
    "bar": 0.82
  },
  "pattern_types": [
    "exact_same_device",
    "same_email"
  ],
  "signal_types": [
    "device",
    "email"
  ],
  "member_counts": {
    "total": 3,
    "users": 3,
    "businesses": 0,
    "transaction_parties": 0
  },
  "member_status": {
    "approved": 1,
    "declined": 1,
    "in_review": 0,
    "not_completed": 1
  },
  "signal_coverage": {
    "device": {
      "signals": 1,
      "subjects": 3,
      "coverage": 1
    },
    "email": {
      "signals": 1,
      "subjects": 2,
      "coverage": 0.6667
    }
  },
  "first_activity_at": "2026-10-01T09:12:44Z",
  "last_activity_at": "2026-10-12T16:03:10Z",
  "stats": {
    "members": {
      "total": 3,
      "users": 3,
      "businesses": 0,
      "transaction_parties": 0
    },
    "member_status": {
      "approved": 1,
      "declined": 1,
      "in_review": 0,
      "not_completed": 1
    },
    "signals": {
      "total": 2,
      "by_type": {
        "device": {
          "signals": 1,
          "subjects": 3,
          "coverage": 1
        },
        "email": {
          "signals": 1,
          "subjects": 2,
          "coverage": 0.6667
        }
      }
    }
  },
  "fraud_tags": [],
  "risk_signals": {
    "residential_proxy_reuse": {
      "detected": false,
      "signal_count": 0,
      "max_subject_count": 0
    },
    "email_intelligence": {
      "enriched_signal_count": 1,
      "high_risk_count": 0,
      "social_profile_count": 0
    },
    "phone_intelligence": {
      "enriched_signal_count": 0,
      "high_risk_count": 0
    }
  },
  "reviewed_at": "2026-10-12T16:30:00Z",
  "reviewed_by": "reviewer@example.com",
  "review_reason": "Shared device across three new accounts.",
  "notes_count": 0,
  "sharing_mode": "global",
  "cross_org_available": true,
  "cross_org_unavailable_reason": null,
  "tags": [
    {
      "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "SUSPICIOUS",
      "color": "#6366F1",
      "source": "custom",
      "added_by": null,
      "added_at": "2026-10-13T08:15:00Z"
    }
  ],
  "outcomes": {
    "approved": 1,
    "declined": 1,
    "in_review": 0,
    "total": 3
  },
  "patterns": [
    {
      "type": "background",
      "score": 0.8125,
      "members": 3,
      "reason": null,
      "computed_at": "2026-10-13T08:00:00Z"
    }
  ]
}

استرجع شبكة واحدة مع كل ما يلزم لعرض لوحة نظرة عامة على الشبكة: تفصيل المخاطر، ووسوم الاحتيال المكتشفة، وملخصات إشارات المخاطر، إلى جانب الحقول المشتركة مع القائمة. يتضمن التفصيل أيضًا وسوم تطبيقك على الشبكة، وحالة عمليات التحقق الخاصة بأعضائها، ومدى تشابه خلفيات صور السيلفي الخاصة بهم.

الوسوم

يسرد tags وسوم تطبيقك على الشبكة، من الأقدم إلى الأحدث. لا يرى كل تطبيق إلا وسومه الخاصة ولا يعدّل إلا وسومه الخاصة. يكون added_by البريد الإلكتروني لعضو وحدة التحكم الذي أضاف الوسم، أو null عندما يكون مفتاح API هو من أضافه. استخدم إضافة وسم إلى شبكة وإزالة وسم من شبكة لتغييرها. أما fraud_tags فلم يتغير: إذ يسرد الوسوم التي يحملها أعضاء الشبكة.

نتائج الأعضاء

يحسب outcomes عدد الأشخاص والشركات الذين قد تراهم في الشبكة، مع احتساب كل واحد منهم مرة واحدة.

المفتاح	ما الذي يحسبه
`approved`	الأعضاء الذين كانت آخر عملية تحقق محسومة لهم مقبولة
`declined`	الأعضاء الذين كانت آخر عملية تحقق محسومة لهم مرفوضة
`in_review`	الأعضاء الذين تقف آخر عملية تحقق محسومة لهم قيد المراجعة
`total`	الأعضاء الذين لديهم عملية تحقق واحدة على الأقل، محسومة كانت أو غير محسومة

يُحتسب العضو الذي رُفض ثم قُبل لاحقًا بعد إعادة المحاولة ضمن approved. أما العضو الذي تكون كل عمليات التحقق الخاصة به غير محسومة (لم تبدأ، أو قيد التنفيذ، أو منتهية الصلاحية، أو متروكة) فيُحتسب ضمن total فقط. لا تخضع أطراف المعاملات لأي عملية تحقق، ولذلك لا تُحتسب.

نمط خلفية صورة السيلفي

يحتوي patterns حاليًا على عنصر واحد، وقيمة type فيه هي background. يمثل score، وهو قيمة من 0 إلى 1، متوسط التشابه بين كل زوج من خلفيات صور السيلفي للأعضاء، مع إخفاء الشخص في الصورة. تشير القيمة القريبة من 1 إلى أن صور السيلفي التُقطت في المكان نفسه. وقد تحصل الجدران السادة ذات الألوان المتشابهة على درجة مرتفعة أيضًا، لذا تعامل مع الدرجة بوصفها دليلًا يستحق المراجعة، لا إثباتًا. تقرأ الدرجة أحدث صورة سيلفي لكل شخص، بحد أقصاه أحدث 50 صورة، وتستثني جلسات التحقق من العمر. وتشمل الدرجة الشبكة كلها، لا أعضاء تطبيقاتك فقط.

`reason`	`score`	`members`	ما الذي يجب فعله
`null`	من 0 إلى 1	عدد صور السيلفي التي جرت مقارنتها	استخدم الدرجة. يوضح `computed_at` وقت حسابها.
`computing`	`null`	`null`	يجري حساب الدرجة للأعضاء الحاليين. اقرأ الشبكة مرة أخرى لاحقًا.
`not_enough_selfies`	`null`	`0` أو `1`	لدى أقل من عضوين صور سيلفي صالحة للاستخدام.

لا تُقارن صورة السيلفي التي لا يمكن قراءتها، أو التي تُظهر خلفية قليلة جدًا، ولهذا قد يكون members أقل من عدد الأشخاص في الشبكة. تصف الدرجة دائمًا صور السيلفي الحالية للأعضاء. وعندما يتغير الأعضاء، مثلًا عند انضمام عضو أو مغادرته، يعرض التفصيل القيمة computing إلى أن تصبح الدرجة الجديدة جاهزة، أو القيمة not_enough_selfies إذا بقي أقل من عضوين.

التوفر عبر المؤسسات

يتضمن التفصيل القيم نفسها sharing_mode وcross_org_available وcross_org_unavailable_reason الموجودة في سرد الشبكات. تحتاج الإشارات عبر المؤسسات إلى خطة Enterprise ووضع المشاركة global معًا.

مواضيع ذات صلة

التفويضات

x-api-key

string

header

مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

معلمات المسار

organization_id

string<uuid>

مطلوب

UUID الخاص بالمؤسسة.

application_id

string<uuid>

مطلوب

معرّف UUID للتطبيق.

network_uuid

string<uuid>

مطلوب

معرّف UUID للشبكة.

مثال:

"n3a5e000-0000-4000-8000-000000000001"

الاستجابة

تفاصيل الشبكة.

تفاصيل الشبكة، بالإضافة إلى وضع المشاركة الخاص بالمؤسسة، وما إذا كانت الإشارات المشتركة بين المؤسسات تنطبق عليها، وعلامات تطبيقك على الشبكة، ونتائج الأعضاء، ودرجات الأنماط.

uuid

string<uuid>

network_id

string

معرّف تسلسلي مقروء للبشر لكل مؤسسة، مثل N-0001.

name

string | null

status

enum<string>

حالة دورة حياة الشبكة. تختلف عن outcome_status لكل مقدم طلب داخل الشبكة (approved/in_review/declined/not_completed).

الخيارات المتاحة:

active,

in_review,

resolved,

dismissed

risk

object

Show child attributes

pattern_types

enum<string>[]

أنماط التجميع المكتشفة في هذه الشبكة.

الخيارات المتاحة:

exact_same_device,

similar_device,

same_ip_address,

same_address,

similar_selfie_backgrounds,

similar_poa_documents,

same_document_number,

same_phone_number,

same_email

signal_types

enum<string>[]

أنواع الإشارات المميزة الموجودة في هذه الشبكة.

الخيارات المتاحة:

ip_address,

device,

face,

document_number,

phone,

email,

address

member_counts

object

أعداد الأعضاء حسب الفئة (مثل الإجمالي، ولكل outcome_status).

member_status

object

تفصيل الأعضاء حسب outcome_status.

signal_coverage

object

تغطية أعضاء هذه الشبكة لكل signal_type.

first_activity_at

string<date-time> | null

last_activity_at

string<date-time> | null

stats

object

إحصائيات مجمعة للشبكة (مثل إجمالي الأعضاء).

fraud_tags

object[]

وسوم أنماط الاحتيال التي ظهرت على الشبكة.

risk_signals

object

ملخصات إشارات المخاطر: residential_proxy_reuse، وemail_intelligence، وphone_intelligence.

reviewed_at

string<date-time> | null

reviewed_by

string | null

review_reason

string | null

notes_count

integer

read-only

عدد ملاحظات المحلل الخاصة في هذا التحقيق.

النطاق المطلوب: x >= 0

وضع المشاركة بين المؤسسات الخاص بالمؤسسة. تقارن القيمة global فقط الشبكات عبر المؤسسات؛ بينما تقصر القيمتان private وoff المقارنة على سجل المؤسسة الخاص فقط.

الخيارات المتاحة:

off,

private,

global

مثال:

"global"

cross_org_available

boolean

ما إذا كانت الإشارات المشتركة بين المؤسسات تسري على هذه المؤسسة. تتطلب كلاً من خطة Enterprise ووضع المشاركة global.

مثال:

true

cross_org_unavailable_reason

enum<string> | null

سبب عدم تطبيق الإشارات المشتركة بين المؤسسات، ويتم التحقق منها بهذا الترتيب. plan: خطة المؤسسة لا تتضمن شبكة مكافحة الاحتيال المشتركة بين المؤسسات (تتطلب خطة Enterprise)، أياً كان وضع المشاركة. sharing_mode: تتضمن الخطة الميزة، لكن وضع المشاركة هو private أو off. تكون Null عندما تكون قيمة cross_org_available هي true.

الخيارات المتاحة:

plan,

sharing_mode

مثال:

null

​الوسوم

​نتائج الأعضاء

​نمط خلفية صورة السيلفي

​التوفر عبر المؤسسات

​مواضيع ذات صلة

التفويضات

معلمات المسار

الاستجابة

الوسوم

نتائج الأعضاء

نمط خلفية صورة السيلفي

التوفر عبر المؤسسات

مواضيع ذات صلة