> ## 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's geographic footprint through the Management API.

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

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

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

Response 200: NetworkMap - { network: NetworkDetail, convergence_count: int, countries: [string, ...], points: [{uuid, country, country_code, city, latitude, longitude, observed_at}, ...] }.
Points are sourced from the sessions, business sessions, and transactions backing the network's memberships (IP geolocation and proof-of-address data).

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.`

\
الصق في استرجع النقاط الجغرافية التي يتقارب فيها أعضاء هذه الشبكة، بحيث يظهر إدخال واحد لكل موقع مُلاحَظ. يمثل `convergence_count` عدد النقاط المتميزة التي يشترك فيها عدة أعضاء، وهو مفيد لاكتشاف شبكة ترتكز على عنوان واحد أو مدينة واحدة، حتى عندما لا يبدو أعضاؤها مرتبطين بخلاف ذلك. يدعم ذلك عرض الخريطة للشبكة في وحدة التحكم.## ذات صلة- [الحصول على الشبكة](https://docs.didit.me/ar/management-api/networks/get.md) - [الجدول الزمني للشبكة](https://docs.didit.me/ar/management-api/networks/timeline.md) - [أعضاء الشبكة](https://docs.didit.me/ar/management-api/networks/members.md) ## OpenAPI ````yaml ar/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/map/ 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}/map/: get: tags: - Networks summary: الحصول على خريطة الشبكة description: >- النقاط الجغرافية التي تلتقي فيها عناوين/مواقع أعضاء هذه الشبكة، والمستمدة من الجلسات، وجلسات الشركات، والمعاملات الداعمة لعضوياتها. operationId: get_network_map 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: $ref: '#/components/schemas/NetworkMap' '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/map/' \ -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_map( "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.retrieveMap("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.RetrieveMap(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().retrieveMap("n3a5e000-0000-4000-8000-000000000001"); System.out.println(result); - lang: php label: PHP source: >- networks->retrieveMap('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_map("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.RetrieveMapAsync("n3a5e000-0000-4000-8000-000000000001"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: NetworkMap: type: object properties: network: $ref: '#/components/schemas/NetworkDetail' convergence_count: type: integer description: عدد نقاط العناوين/المواقع المتميزة التي يلتقي عندها الأعضاء. countries: type: array items: type: string points: type: array items: type: object properties: uuid: type: string format: uuid country: type: string nullable: true country_code: type: string nullable: true city: type: string nullable: true latitude: type: number format: float nullable: true longitude: type: number format: float nullable: true observed_at: type: string format: date-time nullable: true 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: عدد ملاحظات المحلل الخاصة في هذا التحقيق. 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.