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

# طلب الوصول إلى شبكة Travel Rule عبر واجهة برمجة التطبيقات

> اطلب من Didit حمل تطبيقك كمشارك مستقل في GTR أو Sygna بعد الموافقة على استبيانك.

تعليمات طلب واجهة API لشبكة Travel Rule
نسخ الموجّه إلى الحافظة

<pre>
  \`Ask Didit to carry my application on a Travel Rule network as my own participant.

  Endpoint:
  POST [https://verification.didit.me/v3/travel-rule/networks/\{network}/request/](https://verification.didit.me/v3/travel-rule/networks/\{network}/request/)
  network: gtr | sygna

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

  Behavior:

  * Without an approved questionnaire, the participant waits for it (status questionnaire\_pending).
  * With one, it goes to the network's onboarding (submitted\_to\_network) and becomes active once the network gives it a participant code.
  * Idempotent: a pending, onboarding or active participant is returned unchanged.
  * If the network refused the registration (last\_error is set and the network's state is error / provisioning\_failed), requesting again retries.
  * 400 travel\_rule\_network\_own\_membership\_only for TRUST and VerifyVASP (connect your own membership instead), 400 travel\_rule\_network\_sandbox\_application from a sandbox application, 403 travel\_rule\_platform\_networks\_disabled until network access through Didit opens.

  What to read from the response:

  * status, participant\_code, last\_error and history of my participant.

  Full guide: /transaction-monitoring/travel-rule.\`
</pre>

الصق في

اقرأ النتيجة في [الحصول على شبكات Travel Rule](https://docs.didit.me/ar/management-api/travel-rule/get-networks.md): تصبح قيمة `state` للشبكة `live_through_didit` بعد أن يصبح المشارك الخاص بك نشطًا، وتكون عضوية Didit في تلك الشبكة فعّالة.


## OpenAPI

````yaml ar/openapi-25.json POST /v3/travel-rule/networks/{network}/request/
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/travel-rule/networks/{network}/request/:
    post:
      tags:
        - Travel Rule
      summary: طلب شبكة Travel Rule
      description: >-
        طلب المشارك الخاص بهذا التطبيق على شبكة تشملها عضوية Didit (مثل GTR أو
        Sygna). بدون استبيان معتمد، ينتظر المشارك ذلك (questionnaire_pending)؛
        ومع وجود استبيان معتمد، ينتقل إلى مرحلة التسجيل على الشبكة
        (submitted_to_network) ويصبح نشطاً بمجرد أن تمنحه الشبكة رمزاً. الإجراء
        idempotent: يتم إرجاع المشارك المعلق أو قيد التسجيل أو النشط دون تغيير.
        إذا رفضت الشبكة التسجيل (تم تعيين last_error)، فإن إرسال الطلب مرة أخرى
        يؤدي إلى إعادة المحاولة. لا يمكن الوصول إلى TRUST وVerifyVASP إلا من
        خلال عضويتك الخاصة: تقبل TRUST الأعضاء لكل VASP، وتخدم VerifyVASP
        Enclave معرّف VASP واحداً.
      operationId: requestTravelRuleNetworkAccess
      parameters:
        - name: network
          in: path
          required: true
          schema:
            type: string
            enum:
              - gtr
              - sygna
          description: الشبكة المطلوب الانضمام إليها من خلال عضوية Didit.
      responses:
        '200':
          description: المشارك الخاص بك على الشبكة.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TravelRuleNetworkParticipant'
        '400':
          description: >-
            شبكة غير معروفة، أو شبكة لا تدعمها Didit (اربط عضويتك الخاصة)، أو
            تطبيق في البيئة التجريبية.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                    enum:
                      - travel_rule_network_own_membership_only
                      - travel_rule_network_sandbox_application
        '401':
          description: مفتاح API مفقود أو غير صالح.
        '403':
          description: الوصول إلى الشبكة عبر عضوية Didit ليس مفتوحاً بعد.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                    enum:
                      - travel_rule_platform_networks_disabled
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X POST
            https://verification.didit.me/v3/travel-rule/networks/gtr/request/ \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.travel_rule.networks.request_access(
                "your-network",
            )
            print(result)
        - lang: javascript
          label: Node.js
          source: >-
            import Didit from "@didit-protocol/sdk-node";


            // Reads DIDIT_API_KEY.

            const didit = new Didit();


            const result = await
            didit.travelRule.networks.requestAccess("your-network");

            console.log(result);
        - lang: java
          label: Java
          source: >-
            import me.didit.Didit;


            // Reads DIDIT_API_KEY.

            Didit client = new Didit();


            var result =
            client.travelRule().networks().requestAccess("your-network");

            System.out.println(result);
        - lang: php
          label: PHP
          source: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $result =
            $didit->travelRule->networks->requestAccess('your-network');

            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY.
            didit = Didit::Client.new

            result = didit.travel_rule.networks.request_access("your-network")
            puts result.to_h
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using System.Text.Json;

            using Didit;


            // Reads DIDIT_API_KEY.

            using var client = new DiditClient();


            var result = await
            client.TravelRule.Networks.RequestAccessAsync("your-network");

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    TravelRuleNetworkParticipant:
      type: object
      description: المشارك الخاص بهذا التطبيق على شبكة واحدة.
      properties:
        network:
          type: string
          enum:
            - gtr
            - trust
            - verifyvasp
            - sygna
        rail:
          type: string
          enum:
            - GTR
            - TRUST
            - VERIFYVASP
            - SYGNA
        mode:
          type: string
          enum:
            - platform
            - own
        status:
          type: string
          enum:
            - not_requested
            - questionnaire_pending
            - submitted_to_network
            - active
            - suspended
            - rejected
          description: >-
            not_requested: لم يُطلب قط، أو أن الشبكة رفضت الطلب الأول (راجع
            last_error)؛ questionnaire_pending: بانتظار الموافقة على استبيان
            العناية الواجبة؛ submitted_to_network: تم تسليمه لعملية تسجيل
            الشبكة؛ active: منحت الشبكة هذا التطبيق رمز المشارك الخاص به؛
            suspended / rejected: قامت Didit بتعليقه أو رفضه.
        participant_code:
          type: string
        requested_at:
          type: string
          format: date-time
          nullable: true
        submitted_at:
          type: string
          format: date-time
          nullable: true
        activated_at:
          type: string
          format: date-time
          nullable: true
        suspended_at:
          type: string
          format: date-time
          nullable: true
        last_error:
          type: string
          description: رد الشبكة عندما رفضت التسجيل؛ وفارغ بخلاف ذلك.
        history:
          type: array
          readOnly: true
          description: كل تغيير في الحالة، الأقدم أولاً.
          items:
            type: object
            properties:
              at:
                type: string
                format: date-time
              from:
                type: string
              to:
                type: string
              note:
                type: string
                description: ملاحظة المراجعة أو رد الشبكة، عند توفره.
  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.