> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # واجهة API لمخطط شبكة الاحتيال > يسترجع Didit شبكة احتيال على شكل مخطط يضم عقد الموضوع وعقد الإشارات، ويتيح معامل العمق حصر نطاق الجوار حول الموضوع المحوري. موجّه واجهة برمجة تطبيقات الرسم البياني للشبكة نسخ الموجّه إلى الحافظة \

\`Retrieve a fraud network as a graph through the Management API.

Endpoint:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/graph/

Authentication:
Use the x-api-key header with my Didit API key.

Path parameter:
\- network_uuid - the network's UUID.

Query params:
\- depth=1|2|3|all - hops from the focus subject to include. Defaults to all (unbounded).
\- focus_kind=vendor_user|vendor_business|transaction_party - must be supplied together with focus_id.
\- focus_id= - subject UUID to center the graph on.

Response 200: NetworkGraph - { network: NetworkDetail, depth: int|null, truncated: bool, nodes: [...], edges: [...], metrics: {node_count, edge_count, hub_signal_count} }.

Node shapes:
\- Subject node (kind: vendor_user | vendor_business | transaction_party): id, kind, subject, node_status (approved|in_review|declined|not_completed), tags.
\- Signal node (kind: signal): id, kind, uuid, signal_type, subject_count, coverage, is_hub, is_datacenter_ip, is_high_collision_device, node_status (signal_active|signal_guarded), tags, risk_evidence, first_seen_at, last_seen_at.

Edge shape: id, source (subject node id), target (signal node id), subject_kind, signal_type, confidence, observation_count, first_seen_at, last_seen_at.

Failure modes:
\- 404 - network not found or not visible.
\- 400 - depth is not one of 1, 2, 3, all, or focus_kind/focus_id supplied without the other.
\- 401/403 - auth/permission errors.

Side effects: none, pure read.

For the full integration shape, see /integration/integration-prompt.`

\
الصق في استرجع الشبكة على شكل رسم بياني: عقد للموضوع لكل مستخدم أو شركة تابعين للبائع أو طرف في معاملة ضمن الشبكة، وعقد للإشارات لكل جهاز أو عنوان IP أو وجه أو رقم مستند أو رقم هاتف أو عنوان بريد إلكتروني أو عنوان مشترك يربط بينها، والحواف التي تمثل العضويات بينها.استخدم `depth` لتحديد عدد القفزات بعيداً عن موضوع `focus_kind`/`focus_id` المراد إرجاعه. هذا ما تعتمد عليه طريقة عرض الرسم البياني في وحدة التحكم، إذ تُكبّر لعرض الروابط المباشرة لمقدّم طلب واحد بدلاً من تحميل الشبكة كاملة. احذف `depth` (أو مرّر `all`) للحصول على الجوار الكامل. يخبرك `truncated` ما إذا كان الطلب المحدود قد أسقط أي عناصر.## ذات صلة- [احصل على الشبكة](https://docs.didit.me/ar/management-api/networks/get.md) - [أعضاء الشبكة](https://docs.didit.me/ar/management-api/networks/members.md) - [إشارات الشبكة](https://docs.didit.me/ar/management-api/networks/signals.md) ## OpenAPI ````yaml ar/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/graph/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API التحقق من الهوية. قم بالمصادقة باستخدام الرأس x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/graph/: get: tags: - Networks summary: الحصول على مخطط الشبكة description: >- استرجع الشبكة كمخطط لعقد الأطراف المعنية (مستخدمو المورد، وشركات المورد، وأطراف المعاملة) وعقد الإشارات (قيم الجهاز/عنوان IP/الوجه/المستند/الهاتف/البريد الإلكتروني/العنوان المشتركة التي تربط بينها)، مع حواف تمثل العضويات. operationId: get_network_graph parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID الخاص بالمؤسسة. - name: application_id in: path required: true schema: type: string format: uuid description: معرّف UUID للتطبيق. - name: network_uuid in: path required: true schema: type: string format: uuid example: n3a5e000-0000-4000-8000-000000000001 description: معرّف UUID للشبكة. - name: depth in: query schema: type: string enum: - '1' - '2' - '3' - all description: >- القفزات المراد تضمينها من الكيان محل التركيز. القيمة الافتراضية هي الكل (غير محدود). - name: focus_kind in: query schema: type: string enum: - vendor_user - vendor_business - transaction_party description: >- نوع الموضوع لتركيز المخطط عليه. يجب تقديمه مع focus_id؛ ويتم تعيينه افتراضياً إلى عضو عشوائي عندما يكون العمق محدوداً ولا يتم تقديم أي منهما. - name: focus_id in: query schema: type: string format: uuid description: معرّف UUID للموضوع لتركيز المخطط عليه. responses: '200': description: مخطط الشبكة. content: application/json: schema: $ref: '#/components/schemas/NetworkGraph' '404': description: لم يتم العثور على الشبكة (أو أنها غير مرئية لهذا التطبيق). content: application/json: schema: type: object properties: detail: type: string security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- 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/graph/?depth=2' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() result = client.networks.retrieve_graph( "n3a5e000-0000-4000-8000-000000000001", ) print(result) - lang: javascript label: Node.js source: >- 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.retrieveGraph("n3a5e000-0000-4000-8000-000000000001"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Networks.RetrieveGraph(ctx, \"n3a5e000-0000-4000-8000-000000000001\", didit.NetworksRetrieveGraphParams{})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.networks().retrieveGraph("n3a5e000-0000-4000-8000-000000000001"); System.out.println(result); - lang: php label: PHP source: >- networks->retrieveGraph('n3a5e000-0000-4000-8000-000000000001'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new result = didit.networks.retrieve_graph("n3a5e000-0000-4000-8000-000000000001") puts result.to_h - lang: csharp label: .NET source: >- 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.RetrieveGraphAsync("n3a5e000-0000-4000-8000-000000000001"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: NetworkGraph: type: object properties: network: $ref: '#/components/schemas/NetworkDetail' depth: type: integer nullable: true description: العمق الفعلي المطبق، أو null عندما يكون غير مقيد (depth=all). truncated: type: boolean description: تكون القيمة True إذا تم اقتطاع الجوار بناءً على العمق. nodes: type: array items: $ref: '#/components/schemas/NetworkGraphNode' edges: type: array items: $ref: '#/components/schemas/NetworkGraphEdge' metrics: type: object properties: node_count: type: integer edge_count: type: integer hub_signal_count: type: integer NetworkDetail: allOf: - $ref: '#/components/schemas/NetworkListItem' - type: object properties: stats: type: object description: إحصائيات مجمعة للشبكة (مثل إجمالي الأعضاء). fraud_tags: type: array items: type: object description: وسوم أنماط الاحتيال التي ظهرت على الشبكة. risk_signals: type: object description: >- ملخصات إشارات المخاطر: residential_proxy_reuse، وemail_intelligence، وphone_intelligence. reviewed_at: type: string format: date-time nullable: true reviewed_by: type: string nullable: true review_reason: type: string nullable: true properties: notes_count: type: integer minimum: 0 readOnly: true description: عدد ملاحظات المحلل الخاصة في هذا التحقيق. NetworkGraphNode: type: object description: >- عقدة موضوع أو عقدة إشارة، تتميز حسب النوع. عقد الموضوع (النوع: vendor_user | vendor_business | transaction_party) تحمل id و kind و subject و node_status (approved | in_review | declined | not_completed) والوسوم. عقد الإشارة (النوع: signal) تحمل id و kind و uuid و signal_type و subject_count و coverage و is_hub و is_datacenter_ip و is_high_collision_device و node_status (signal_active | signal_guarded) والوسوم و risk_evidence و first_seen_at و last_seen_at. properties: id: type: string kind: type: string enum: - vendor_user - vendor_business - transaction_party - signal NetworkGraphEdge: type: object properties: id: type: string format: uuid source: type: string description: معرّف العقدة للموضوع. target: type: string description: معرّف عقدة الإشارة. subject_kind: type: string enum: - vendor_user - vendor_business - transaction_party signal_type: type: string enum: - ip_address - device - face - document_number - phone - email - address confidence: type: number format: float description: 1.0 للتطابق التام. observation_count: type: integer first_seen_at: type: string format: date-time nullable: true last_seen_at: type: string format: date-time nullable: true NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: معرّف تسلسلي مقروء للبشر لكل مؤسسة، مثل N-0001. name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- حالة دورة حياة الشبكة. تختلف عن outcome_status لكل مقدم طلب داخل الشبكة (approved/in_review/declined/not_completed). risk: $ref: '#/components/schemas/NetworkRiskDisplay' pattern_types: type: array items: type: string enum: - exact_same_device - similar_device - same_ip_address - same_address - similar_selfie_backgrounds - similar_poa_documents - same_document_number - same_phone_number - same_email description: أنماط التجميع المكتشفة في هذه الشبكة. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: أنواع الإشارات المميزة الموجودة في هذه الشبكة. member_counts: type: object description: أعداد الأعضاء حسب الفئة (مثل الإجمالي، ولكل outcome_status). member_status: type: object description: تفصيل الأعضاء حسب outcome_status. signal_coverage: type: object description: تغطية أعضاء هذه الشبكة لكل signal_type. first_activity_at: type: string format: date-time nullable: true last_activity_at: type: string format: date-time nullable: true NetworkRiskDisplay: type: object properties: score: type: integer description: درجة المخاطر، من 0 إلى 100. band: type: string enum: - low - medium - high description: >- النطاق الذي تظهر فيه الدرجة. high >= 70، وmedium >= 40، وخلاف ذلك low. bar: type: number format: float description: قيمة معيارية من 0 إلى 1 لعرض شريط المخاطر. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.