> ## 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. تعيد الاستجابة تفاصيل الشبكة مع وسومها. موجّه API لإضافة وسم للشبكة نسخ الموجّه إلى الحافظة \

\`Put one of my application's tags on a fraud network through the Management API.

Endpoint:
POST https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/tags/add/

Authentication:
Use the x-api-key header with my Didit API key.
Networks endpoints need a full-access API key: a key with restricted access gets 403.

Path parameter:
\- network_uuid: the network's UUID, from list networks.

Request body:
\{"tag_uuid": ""}

Example call:
curl -X POST "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/tags/add/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"tag_uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7"}'

Behavior:
\- 201 when the tag was added, 200 when it was already on the network (left as it is). Safe to retry.
\- Both return the network detail (same shape as get network). Its tags array lists my application's tags on the network, oldest first: {uuid, name, color, source (didit|custom), added_by, added_at}.
\- added_by is null when an API key adds the tag, and the console member's email when a member does.
\- Each application sees and changes only its own tags. fraud_tags (the tags the members carry) is not affected.

Failure modes:
\- 400: tag_uuid missing or not a UUID. {"tag_uuid": ["This field is required."]}
\- 404: {"detail": "Network not found."} (the network does not exist or has no member visible to this application), or {"detail": "Tag not found."} (the tag does not exist or belongs to another application).
\- 401: missing or invalid x-api-key.
\- 403: the API key belongs to another application, or it has restricted access (Networks needs a full-access key). A console member token needs write:networks.
\- 403 with {"code": "networks_not_entitled"}: Networks is not enabled for the organization.

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

\
الصق في أضِف أحد وسوم تطبيقك إلى شبكة، على سبيل المثال لوضع علامة عليها للمتابعة أو لتسجيل ما توصّل إليه فريقك. مرّر معرّف UUID الخاص بالوسم من وسوم تطبيقك باستخدام `tag_uuid`. يُرجع الوسم الذي يتبع تطبيقاً آخر الرمز `404`، تماماً مثل الوسم غير الموجود.تكون الاستجابة [تفاصيل الشبكة](https://docs.didit.me/ar/management-api/networks/get.md) كاملةً، مع `201` عند إضافة الوسم و`200` إذا كان موجوداً مسبقاً على الشبكة. استدعاء الطلب مرة أخرى بالوسم نفسه لا يغيّر شيئاً، لذلك يمكنك إعادة المحاولة بأمان.يسرد `tags` وسوم تطبيقك الموجودة على الشبكة، من الأقدم إلى الأحدث. يكون `added_by` بقيمة `null` عندما يضيف مفتاح API الوسم، ويحمل عنوان البريد الإلكتروني لعضو وحدة التحكم عندما يضيفه أحد الأعضاء. لا يتأثر `fraud_tags` الخاص بالشبكة، وهي الوسوم التي يحملها أعضاؤها.## ذات صلة- [احذف وسم الشبكة](https://docs.didit.me/ar/management-api/networks/remove-tag.md) - [الحصول على الشبكة](https://docs.didit.me/ar/management-api/networks/get.md) - [سرد الشبكات](https://docs.didit.me/ar/management-api/networks/list.md) ## OpenAPI ````yaml ar/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/tags/add/ 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}/tags/add/: post: tags: - Networks summary: إضافة وسم إلى شبكة description: >- وضع إحدى علامات تطبيقك على الشبكة. يُرجع تفاصيل الشبكة، التي تسرد خاصية `tags` فيها علامات تطبيقك على الشبكة، مع `201` عند إضافة العلامة و`200` إذا كانت موجودة بالفعل على الشبكة. تُرجع العلامة التي تنتمي إلى تطبيق آخر، أو غير الموجودة، الخطأ 404 `Tag not found.`. يتطلب مفتاح API بصلاحيات وصول كاملة، أو `write:networks` لعضو في لوحة التحكم. operationId: add_network_tag 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: 3fa85f64-5717-4562-b3fc-2c963f66afa6 description: معرّف UUID للشبكة. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/NetworkTagRequest' example: tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 responses: '200': description: الوسم موجود بالفعل على الشبكة وتُرك كما هو. يُرجع تفاصيل الشبكة. content: application/json: schema: $ref: '#/components/schemas/NetworkDetailResponse' example: uuid: 3fa85f64-5717-4562-b3fc-2c963f66afa6 network_id: N-0042 name: null status: in_review risk: score: 82 band: high bar: 0.82 pattern_types: - exact_same_device - same_email signal_types: - device - email member_counts: total: 3 users: 3 businesses: 0 transaction_parties: 0 member_status: approved: 1 declined: 1 in_review: 0 not_completed: 1 signal_coverage: device: signals: 1 subjects: 3 coverage: 1 email: signals: 1 subjects: 2 coverage: 0.6667 first_activity_at: '2026-10-01T09:12:44Z' last_activity_at: '2026-10-12T16:03:10Z' stats: members: total: 3 users: 3 businesses: 0 transaction_parties: 0 member_status: approved: 1 declined: 1 in_review: 0 not_completed: 1 signals: total: 2 by_type: device: signals: 1 subjects: 3 coverage: 1 email: signals: 1 subjects: 2 coverage: 0.6667 fraud_tags: [] risk_signals: residential_proxy_reuse: detected: false signal_count: 0 max_subject_count: 0 email_intelligence: enriched_signal_count: 1 high_risk_count: 0 social_profile_count: 0 phone_intelligence: enriched_signal_count: 0 high_risk_count: 0 reviewed_at: '2026-10-12T16:30:00Z' reviewed_by: reviewer@example.com review_reason: Shared device across three new accounts. notes_count: 0 sharing_mode: global cross_org_available: true cross_org_unavailable_reason: null tags: - uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 name: SUSPICIOUS color: '#6366F1' source: custom added_by: null added_at: '2026-10-13T08:15:00Z' outcomes: approved: 1 declined: 1 in_review: 0 total: 3 patterns: - type: background score: 0.8125 members: 3 reason: null computed_at: '2026-10-13T08:00:00Z' '201': description: تمت إضافة الوسم. يُرجع تفاصيل الشبكة. content: application/json: schema: $ref: '#/components/schemas/NetworkDetailResponse' example: uuid: 3fa85f64-5717-4562-b3fc-2c963f66afa6 network_id: N-0042 name: null status: in_review risk: score: 82 band: high bar: 0.82 pattern_types: - exact_same_device - same_email signal_types: - device - email member_counts: total: 3 users: 3 businesses: 0 transaction_parties: 0 member_status: approved: 1 declined: 1 in_review: 0 not_completed: 1 signal_coverage: device: signals: 1 subjects: 3 coverage: 1 email: signals: 1 subjects: 2 coverage: 0.6667 first_activity_at: '2026-10-01T09:12:44Z' last_activity_at: '2026-10-12T16:03:10Z' stats: members: total: 3 users: 3 businesses: 0 transaction_parties: 0 member_status: approved: 1 declined: 1 in_review: 0 not_completed: 1 signals: total: 2 by_type: device: signals: 1 subjects: 3 coverage: 1 email: signals: 1 subjects: 2 coverage: 0.6667 fraud_tags: [] risk_signals: residential_proxy_reuse: detected: false signal_count: 0 max_subject_count: 0 email_intelligence: enriched_signal_count: 1 high_risk_count: 0 social_profile_count: 0 phone_intelligence: enriched_signal_count: 0 high_risk_count: 0 reviewed_at: '2026-10-12T16:30:00Z' reviewed_by: reviewer@example.com review_reason: Shared device across three new accounts. notes_count: 0 sharing_mode: global cross_org_available: true cross_org_unavailable_reason: null tags: - uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 name: SUSPICIOUS color: '#6366F1' source: custom added_by: null added_at: '2026-10-13T08:15:00Z' outcomes: approved: 1 declined: 1 in_review: 0 total: 3 patterns: - type: background score: 0.8125 members: 3 reason: null computed_at: '2026-10-13T08:00:00Z' '400': description: 'جسم الطلب غير صالح: `tag_uuid` مفقود أو ليس UUID.' content: application/json: schema: type: object properties: tag_uuid: type: array items: type: string examples: Missing tag_uuid: summary: tag_uuid مفقود value: tag_uuid: - This field is required. Invalid tag_uuid: summary: tag_uuid غير صالح value: tag_uuid: - Must be a valid UUID. '401': description: بيانات اعتماد مفقودة أو غير صالحة. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- موجود في الأخطاء ذات الرموز، على سبيل المثال `networks_not_entitled`. examples: Missing or invalid credentials: summary: بيانات اعتماد مفقودة أو غير صالحة value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- ينتمي مفتاح API إلى تطبيق آخر، أو أنه مفتاح ذو وصول مقيد: تتطلب endpoint الخاصة بـ Networks مفتاحاً كامل الوصول. يتطلب token عضو لوحة التحكم إذن `write:networks`. يتم إرجاعه أيضاً مع `code: networks_not_entitled` عندما لا تكون Networks مفعّلة للمؤسسة. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- موجود في الأخطاء ذات الرموز، على سبيل المثال `networks_not_entitled`. examples: Networks not enabled: summary: الشبكات غير مفعّلة value: detail: >- Networks is disabled for this organization. Contact Didit support if you believe this is an error. code: networks_not_entitled Restricted API key: summary: مفتاح API مقيد value: detail: This API key has no access to this endpoint. No permission: summary: لا يوجد إذن value: detail: You do not have permission to perform this action. '404': description: غير موجود. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- موجود في الأخطاء ذات الرموز، على سبيل المثال `networks_not_entitled`. examples: Network not found: summary: لم يتم العثور على الشبكة value: detail: Network not found. Tag not found: summary: العلامة غير موجودة value: detail: Tag not found. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/3fa85f64-5717-4562-b3fc-2c963f66afa6/tags/add/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"tag_uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7"}' - 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.add_tag( "3fa85f64-5717-4562-b3fc-2c963f66afa6", tag_uuid="7c9e6679-7425-40de-944b-e07fc1f90ae7", ) 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.addTag("3fa85f64-5717-4562-b3fc-2c963f66afa6", { tag_uuid: "7c9e6679-7425-40de-944b-e07fc1f90ae7", }); 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.AddTag(ctx, \"3fa85f64-5717-4562-b3fc-2c963f66afa6\", didit.NetworkTagRequest{\n\tTagUUID: \"7c9e6679-7425-40de-944b-e07fc1f90ae7\",\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.NetworkTagRequest; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.networks().addTag("3fa85f64-5717-4562-b3fc-2c963f66afa6", NetworkTagRequest.builder() .tagUuid("7c9e6679-7425-40de-944b-e07fc1f90ae7") .build()); System.out.println(result); - lang: php label: PHP source: >- networks->addTag('3fa85f64-5717-4562-b3fc-2c963f66afa6', [ 'tag_uuid' => '7c9e6679-7425-40de-944b-e07fc1f90ae7', ]); 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.add_tag( "3fa85f64-5717-4562-b3fc-2c963f66afa6", tag_uuid: "7c9e6679-7425-40de-944b-e07fc1f90ae7" ) 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.AddTagAsync("3fa85f64-5717-4562-b3fc-2c963f66afa6", new NetworkTagRequest { TagUuid = "7c9e6679-7425-40de-944b-e07fc1f90ae7", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: NetworkTagRequest: type: object required: - tag_uuid properties: tag_uuid: type: string format: uuid description: معرّف UUID لإحدى علامات تطبيقك. example: tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 NetworkDetailResponse: description: >- تفاصيل الشبكة، بالإضافة إلى وضع المشاركة الخاص بالمؤسسة، وما إذا كانت الإشارات المشتركة بين المؤسسات تنطبق عليها، وعلامات تطبيقك على الشبكة، ونتائج الأعضاء، ودرجات الأنماط. allOf: - $ref: '#/components/schemas/NetworkDetail' - type: object properties: sharing_mode: type: string enum: - 'off' - private - global description: >- وضع المشاركة بين المؤسسات الخاص بالمؤسسة. تقارن القيمة `global` فقط الشبكات عبر المؤسسات؛ بينما تقصر القيمتان `private` و`off` المقارنة على سجل المؤسسة الخاص فقط. example: global cross_org_available: type: boolean description: >- ما إذا كانت الإشارات المشتركة بين المؤسسات تسري على هذه المؤسسة. تتطلب كلاً من خطة Enterprise ووضع المشاركة `global`. example: true cross_org_unavailable_reason: type: string enum: - plan - sharing_mode nullable: true description: >- سبب عدم تطبيق الإشارات المشتركة بين المؤسسات، ويتم التحقق منها بهذا الترتيب. `plan`: خطة المؤسسة لا تتضمن شبكة مكافحة الاحتيال المشتركة بين المؤسسات (تتطلب خطة Enterprise)، أياً كان وضع المشاركة. `sharing_mode`: تتضمن الخطة الميزة، لكن وضع المشاركة هو `private` أو `off`. تكون Null عندما تكون قيمة `cross_org_available` هي `true`. example: null tags: type: array items: $ref: '#/components/schemas/NetworkTag' description: >- علامات تطبيقك على الشبكة، الأقدم أولاً. يرى كل تطبيق علاماته الخاصة فقط. `fraud_tags` منفصلة ولم تتغير: العلامات التي يحملها أعضاء الشبكة. outcomes: $ref: '#/components/schemas/NetworkOutcomes' patterns: type: array items: $ref: '#/components/schemas/NetworkPatternScore' description: درجات الأنماط عبر الشبكة بأكملها. عنصر واحد اليوم، `background`. 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: عدد ملاحظات المحلل الخاصة في هذا التحقيق. NetworkTag: type: object description: إحدى علامات تطبيقك على الشبكة. properties: uuid: type: string format: uuid description: معرّف UUID الخاص بالوسم، وهو نفس القيمة التي تمررها كـ `tag_uuid`. name: type: string color: type: string description: لون سداسي عشري، على سبيل المثال `#6366F1`. source: type: string enum: - didit - custom description: '`didit` لعلامة مسبقة الضبط من Didit، و`custom` لعلامة أنشأها فريقك.' added_by: type: string nullable: true description: >- البريد الإلكتروني لعضو وحدة التحكم الذي أضاف الوسم. يكون Null عندما يضيفه مفتاح API. added_at: type: string format: date-time NetworkOutcomes: type: object description: >- حالة الأفراد والشركات في الشبكة. يُحسب كل عضو مسموح لك برؤيته مرة واحدة، استناداً إلى حالة أحدث عملية تحقق له انتهت باتخاذ قرار. ولا يتم احتساب أطراف المعاملات. properties: approved: type: integer description: الأعضاء الذين كانت آخر عملية تحقق تم البت فيها خاصة بهم مقبولة. declined: type: integer description: الأعضاء الذين كانت آخر عملية تحقق تم البت فيها خاصة بهم مرفوضة. in_review: type: integer description: >- الأعضاء الذين تكون آخر عملية تحقق تم البت فيها خاصة بهم قيد المراجعة. total: type: integer description: >- الأعضاء الذين لديهم عملية تحقق واحدة على الأقل، سواء تم البت فيها أم لا. العضو الذي تكون جميع عمليات التحقق الخاصة به غير محسومة (لم تبدأ، أو قيد التنفيذ، أو منتهية الصلاحية، أو متروكة) يُحسب هنا ولا يُحسب في أي مفتاح آخر. NetworkPatternScore: type: object description: >- مدى تشابه أحد أنواع بيانات الأعضاء عبر الشبكة بأكملها. النمط ليس إشارة: لا توجد قيمة مشتركة تربط الأعضاء. properties: type: type: string enum: - background description: >- `background`: متوسط التشابه لكل زوج من خلفيات صور السيلفي للأعضاء، مع حجب الشخص. يقرأ أحدث صورة سيلفي لكل شخص، بحد أقصى أحدث 50 صورة، ويستبعد جلسات تأكيد العمر. يغطي الشبكة بالكامل، وليس فقط أعضاء تطبيقاتك. score: type: number nullable: true minimum: 0 maximum: 1 description: من 0 إلى 1، مقرباً إلى 4 منازل عشرية. يكون Null عند تعيين `reason`. members: type: integer nullable: true description: >- عدد صور السيلفي للأعضاء التي قارنتها الدرجة. لا تتم مقارنة صورة السيلفي التي لا يمكن قراءتها، أو التي تظهر خلفية غير كافية. تكون القيمة فارغة Null أثناء حالة `computing`؛ و0 أو 1 مع `not_enough_selfies`. reason: type: string enum: - computing - not_enough_selfies nullable: true description: >- سبب عدم وجود درجة. `computing`: يجري احتساب الدرجة للأعضاء الحاليين؛ أعد قراءة الشبكة لاحقاً. `not_enough_selfies`: أقل من عضوين لديهما صورة سيلفي قابلة للاستخدام. تكون القيمة Null عند توفر درجة. computed_at: type: string format: date-time nullable: true description: متى تم احتساب الدرجة. وتكون Null أثناء `computing`. 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.