الجدول الزمني لشبكة الاحتيال API

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/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

GET

organization

{organization_id}

application

{application_id}

networks

{network_uuid}

timeline

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/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

استرجع سجل الأحداث الخاص بشبكة. بدون contract، تكون الاستجابة سجلّ الشبكة نفسها، من الأقدم إلى الأحدث، وغير مقسّمة إلى صفحات: متى رُصدت الشبكة لأول مرة، ومتى رُصدت آخر مرة كل إشارة، وآخر تغيير في حالة الشبكة مع سببه. هذا الشكل لم يتغير، وlimit وcursor وevent_type يتم تجاهلها.

الخط الزمني ذي الأنواع

مرّر contract=2 لقراءة الخط الزمني ذي الأنواع بدلاً من ذلك. يضيف ما فعلته حسابات الأعضاء وما فعله فريقك تجاه الشبكة، من الأحدث إلى الأقدم، صفحة واحدة في كل مرة. يقبل contract القيمة 2 فقط؛ وأي قيمة أخرى تُرجع 400.

المعامل	المعنى
`limit`	عدد الأحداث في كل صفحة، من 1 إلى 500. القيمة الافتراضية 100.
`cursor`	قيمة `next_cursor` الخاصة بالصفحة السابقة. المؤشر غير الصالح أو الفارغ يُرجع `400`.
`event_type`	أنواع الأحداث المراد الاحتفاظ بها، وتُكرَّر أو تُفصل بفاصلة، بحد أقصى 20 قيمة. القيمة الافتراضية جميع الأنواع.

تكون الاستجابة {"results": [...], "next_cursor": "..."}. لقراءة الصفحة التالية، اضبط cursor على قيمة next_cursor، وكرّر ذلك إلى أن تصبح next_cursor تساوي null.

أنواع الأحداث

`event_type`	ما يسجّله	كتلة التفاصيل
`network_detected`	رُصدت الشبكة	لا شيء
`signal_observed`	آخر رصد لإشارة	لا شيء
`network_active`, `network_in_review`, `network_resolved`, `network_dismissed`	آخر تغيير في حالة الشبكة، مع سببه في `metadata`	لا شيء
`verification_attempt`	جلسة تحقق لأحد الأعضاء (شخص أو شركة)، مرقّمة (`attempt` من `attempt_count`)، مع أسباب الرفض عند الرفض	`verification_attempt`
`transaction`	معاملة شارك فيها أحد الأعضاء، مؤرخة بتاريخ المعاملة	`transaction`
`login`	تسجيل دخول أو محاولة تسجيل دخول فاشلة أرسلتها لأحد الأعضاء عبر واجهة برمجة الأحداث	`login`
`rule_hit`	قاعدة فعّالة طابقت معاملة أو حدثاً لأحد الأعضاء	`rule_hit`
`case_linked`	حالة فُتحت للشبكة في مؤسستك	`case_linked`
`note_added`	ملاحظة أُضيفت إلى الشبكة، دون نصها	`note_added`

تُعاد أحداث note_added لأعضاء لوحة التحكم فقط، ولا تُعاد أبداً لمفتاح API. تظهر المعاملة بين عضوين مرة واحدة لكل منهما، ولكل منهما account الخاص به. تظهر مطابقة القاعدة على تلك المعاملة مرة واحدة. توجد أحداث تسجيل الدخول فقط لعمليات تسجيل الدخول التي ترسلها كأحداث: auth.login وsecurity.login_succeeded وصيغهما الفاشلة.

الحسابات والسجلات

يحمل كل حدث يخص عضوًا account، وهو العضو الذي ينتمي إليه الحدث، وsource_ref، وهو الجلسة أو جلسة الشركة أو المعاملة أو حدث المراقبة أو الحالة التي قُرئ منها الحدث. تكون قيمة ownership هي owned عندما يعود السجل إلى التطبيق الذي استدعيته، وتكون organization عندما يعود إلى تطبيق آخر في مؤسستك. يعطي route نوع السجل ومعرّف UUID الخاص به والتطبيق؛ ولا يحتوي source_ref على route لحدث مراقبة أو لحالة. لا تحمل أحداث الشبكة نفسها account ولا source_ref.

ذات صلة

التفويضات

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"

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

contract

enum<string>

2 تُرجع الجدول الزمني المُنَمَّط. احذفها للحصول على الجدول الزمني الافتراضي. أي قيمة أخرى تُرجع 400.

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

2

limit

integer

افتراضي:100

المخطط الزمني المحدد النوع فقط. الأحداث لكل صفحة، من 1 إلى 500. القيمة الافتراضية هي 100.

النطاق المطلوب: 1 <= x <= 500

cursor

string

المخطط الزمني المحدد النوع فقط. مؤشر next_cursor للصفحة السابقة. يُعيد المؤشر غير الصالح أو الفارغ الرمز 400.

event_type

enum<string>[]

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

Maximum array length: 20

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

network_detected,

signal_observed,

network_active,

network_in_review,

network_resolved,

network_dismissed,

verification_attempt,

transaction,

login,

rule_hit,

case_linked,

note_added

الاستجابة

بدون contract: يتم إرجاع {results}، الأقدم أولاً، بدون تقسيم إلى صفحات. مع contract=2: يتم إرجاع {results, next_cursor}، الأحدث أولاً.

Default timeline (no contract)
Typed timeline page (contract=2)

بدون contract: أحداث الشبكة الخاصة، من الأقدم إلى الأحدث، غير مقسمة إلى صفحات.

results

object[]

Show child attributes

آخر تعديل في ٧ نوفمبر ٢٠٢٦

​الخط الزمني ذي الأنواع

​أنواع الأحداث

​الحسابات والسجلات

​ذات صلة

التفويضات

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

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

الاستجابة

الخط الزمني ذي الأنواع

أنواع الأحداث

الحسابات والسجلات

ذات صلة