> ## 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

> اعرض إشارات الجهاز وعنوان IP والوجه ورقم المستند والهاتف والبريد الإلكتروني والعنوان المشتركة التي تربط أعضاء شبكة احتيال في Didit.



موجّه واجهة API لسرد إشارات الشبكة
        نسخ الموجّه إلى الحافظة



      
      

\<pre>

\`List the signals linking a fraud network's members through the Management API.

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

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

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

Response 200: {"results": [NetworkSignal, ...]} - not paginated.
Each NetworkSignal has uuid, signal_type (ip_address|device|face|document_number|phone|email|address), 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.

Notes:
\- is_hub means the signal links an unusually large number of subjects (e.g. a shared office IP or a device used at a kiosk) - hub signals are flagged rather than treated as automatic fraud evidence.
\- All signal types except face are matched on an exact keyed hash of the normalized value - the raw value is never stored or returned. face is matched by similarity, not exact hash.

Failure modes:
\- 404 - network not found or not visible.
\- 401/403 - auth/permission errors.

Side effects: none, pure read.

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

\</pre>



      
      

الصق في

اعرض الإشارات (بصمات الأجهزة المشتركة، وعناوين IP، والوجوه، وأرقام المستندات، وأرقام الهواتف، ورسائل البريد الإلكتروني، والعناوين) التي تربط أعضاء هذه الشبكة. هذه هي البيانات نفسها التي تحملها عقد الإشارات في المخطط، ولكنها تُعاد في قائمة مسطحة.> [!NOTE]
>
> لا تُعرض قيم الإشارات نفسها أبداً. يُعرَّف كل نوع إشارة مطابقة تامة (`ip_address` و`device` و`document_number` و`phone` و`email` و`address`) بتجزئة مُفتاحية لقيمته الموحَّدة، أما `face` فيُطابَق بالبحث بالتشابه بدلاً من أي قيمة مخزَّنة على الإطلاق.## ذات صلة- [الحصول على الشبكة](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/graph.md)


## OpenAPI

````yaml ar/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/signals/
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}/signals/:
    get:
      tags:
        - Networks
      summary: عرض إشارات الشبكة
      description: >-
        عرض قائمة بالإشارات (قيم الجهاز المشترك، أو عنوان IP، أو الوجه، أو رقم
        المستند، أو الهاتف، أو البريد الإلكتروني، أو العنوان) التي تربط بين
        أعضاء هذه الشبكة.
      operationId: list_network_signals
      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 للشبكة.
      responses:
        '200':
          description: إشارات الشبكة. بدون تقسيم إلى صفحات.
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/NetworkSignal'
        '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/signals/'
            \
              -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.list_signals(
                "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.listSignals("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.ListSignals(ctx, \"n3a5e000-0000-4000-8000-000000000001\")\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().listSignals("n3a5e000-0000-4000-8000-000000000001");

            System.out.println(result);
        - lang: php
          label: PHP
          source: >-
            <?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->listSignals('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.list_signals("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.ListSignalsAsync("n3a5e000-0000-4000-8000-000000000001");

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    NetworkSignal:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        signal_type:
          type: string
          enum:
            - ip_address
            - device
            - face
            - document_number
            - phone
            - email
            - address
        subject_count:
          type: integer
        coverage:
          type: number
          format: float
        is_hub:
          type: boolean
          description: تكون صحيحة عندما تربط هذه الإشارة عدداً كبيراً غير معتاد من الأطراف.
        is_datacenter_ip:
          type: boolean
        is_high_collision_device:
          type: boolean
        node_status:
          type: string
          enum:
            - signal_active
            - signal_guarded
        tags:
          type: array
          items:
            $ref: '#/components/schemas/NetworkNodeTag'
        risk_evidence:
          type: object
        first_seen_at:
          type: string
          format: date-time
          nullable: true
        last_seen_at:
          type: string
          format: date-time
          nullable: true
    NetworkNodeTag:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        color:
          type: string
          nullable: true
          description: Null لعلامات الحماية، إذ يتولى المُصيّر token اللون الخاص بها.
        source:
          type: string
          enum:
            - subject_tag
            - session_tag
            - transaction_tag
            - signal_guard
          description: >-
            مصدر الوسم: وسم على المستخدم/الشركة، أو وسم على جلسة في هذه الشبكة،
            أو وسم على معاملة ينتمي إليها أحد الأطراف، أو شرط حماية الإشارة (مثل
            مركز رئيسي، أو عنوان IP لمركز بيانات).
        category:
          type: string
          enum:
            - customer
            - quality
          nullable: true
          description: >-
            customer للوسوم المحددة من قِبل العميل، وquality لوسوم الحماية
            الخاصة بجودة الإشارة. Null عندما لا ينطبق ذلك.
  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.