الانتقال إلى المحتوى الرئيسي
POST
curl
أزِل أحد وسوم تطبيقك من شبكة. مرّر UUID الوسم في tag_uuid: وهو نفس uuid الذي تعرضه قائمة tags في تفاصيل الشبكة. الاستجابة هي تفاصيل الشبكة كاملةً، ولم تعد tags فيها تتضمن الوسم. لا تتأثر fraud_tags في الشبكة، وهي الوسوم التي يحملها أعضاؤها.

ذات صلة

التفويضات

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 للشبكة.

مثال:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

الجسم

application/json
tag_uuid
string<uuid>
مطلوب

معرّف UUID لإحدى علامات تطبيقك.

الاستجابة

تمت إزالة الوسم من الشبكة. يُرجع تفاصيل الشبكة.

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

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
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
sharing_mode
enum<string>

وضع المشاركة بين المؤسسات الخاص بالمؤسسة. تقارن القيمة 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

tags
object[]

علامات تطبيقك على الشبكة، الأقدم أولاً. يرى كل تطبيق علاماته الخاصة فقط. fraud_tags منفصلة ولم تتغير: العلامات التي يحملها أعضاء الشبكة.

outcomes
object

حالة الأفراد والشركات في الشبكة. يُحسب كل عضو مسموح لك برؤيته مرة واحدة، استناداً إلى حالة أحدث عملية تحقق له انتهت باتخاذ قرار. ولا يتم احتساب أطراف المعاملات.

patterns
object[]

درجات الأنماط عبر الشبكة بأكملها. عنصر واحد اليوم، background.

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