> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# إنشاء تصدير حدث مخاطر

> استمر في مهمة لقطة مصفاة لـ JSON أو CSV أو CEF أو LEEF.

أرسل كائنًا مثل `{ "format": "json", "event_types": ["signal", "decision"] }`. احفظ `export_id` واستعلم نقطة نهاية القراءة. تؤكد استجابة 202 أن المهمة موجودة؛ ولا تؤكد اكتمال المعالجة.

تحتوي صادرات المخاطر على إشارات وقرارات مخاطر مساحة العمل. لا تقوم بتكوين إعادة توجيه سجل التدقيق التلقائي. راجع [تكامل SIEM](https://docs.truthlocks.com/ar/guides/siem-integration.md) للتمييز.


## OpenAPI

````yaml ar/mint-openapi.yaml POST /v1/risk/siem/export
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks هي بنية تحتية عالمية للتحقق من المستندات وبيانات الاعتماد والأصول
    الرقمية.يحدد هذا المواصفات واجهة برمجة التطبيقات (API) الأساسية للتفاعل مع
    خدمات Truthlocks.


    ## عناوين URL الأساسية

    - **الإنتاج**: `https://api.truthlocks.com`

    - **البيئة التجريبية (Sandbox)**: `https://sandbox-api.truthlocks.com`


    ## المصادقة

    - **مفاتيح API**: استخدم رأس `X-API-Key` للعمليات من جهاز إلى جهاز

    - **رموز Bearer**: استخدم `Authorization: Bearer <jwt>` للعمليات التي يبدأها
    المستخدم


    ## هوية المستأجر

    في بيئة الإنتاج، تُستمد هوية المستأجر من السياق المصادق عليه (مفتاح API أو
    JWT).

    يتم تجاهل رأس `X-Tenant-ID` في بيئة الإنتاج لمنع الانتحال.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: واجهة برمجة تطبيقات الإنتاج
  - url: https://sandbox-api.truthlocks.com
    description: بيئة اختبار (Sandbox)
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: إدارة مفاتيح ورموز API
  - name: Issuers
    description: تسجيل المصدر وإدارة الثقة
  - name: Keys
    description: إدارة المفاتيح التشفيرية لجهات الإصدار
  - name: Attestations
    description: دورة حياة الإشهاد (السك، الإلغاء، الاستبدال)
  - name: Verification
    description: حزم التحقق والإثبات للإشهاد
  - name: Governance
    description: سير عمل حوكمة المصدر (للمسؤول فقط)
  - name: Identity
    description: إدارة المنظمة والمستخدمين والأدوار
  - name: Audit
    description: استعلامات أحداث التدقيق
  - name: Tenant Console
    description: ملف تعريف المستأجر ونقاط نهاية دورة الحياة
  - name: Health
    description: نقاط نهاية صحة الخدمة وجاهزيتها
  - name: Risk
    description: استيعاب إشارة المخاطر واكتشاف الاحتيال
  - name: Risk Enforcement
    description: إجراءات إنفاذ المخاطر — الحظر والتحدي والحجر والتكوين
  - name: Billing
    description: إدارة الفوترة والاشتراكات والإضافات
  - name: Machine Identity
    description: >-
      بروتوكول هوية وكيل الآلة (MAIP) — تسجيل الوكيل، الجلسات، الثقة، الشهادة،
      الامتثال، التنسيق، والمراقبة
externalDocs:
  description: واجهة برمجة تطبيقات الشفافية للقراءة فقط (مواصفات خدمة منفصلة)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/risk/siem/export:
    post:
      tags:
        - Risk Exports
      summary: إنشاء تصدير حدث مخاطر
      description: >-
        استمر في مهمة لقطة محدودة لمساحة العمل هذه. هذا لا يقوم بتكوين إعادة
        توجيه السجل أو وجهة SIEM. استعلم عن export_id المعادة لاسترداد النتيجة
        واستئناف المعالجة المعلقة بعد إعادة التشغيل.
      operationId: audit.siem.create
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                format:
                  type: string
                  enum:
                    - json
                    - csv
                    - cef
                    - leef
                  default: json
                event_types:
                  type: array
                  maxItems: 2
                  items:
                    type: string
                    enum:
                      - signal
                      - decision
                  description: >-
                    سجل الفئات المراد تضمينها. فارغ أو محذوف يتضمن كلاهما؛ هذه
                    ليست أسماء مزودين أو أنواع فرعية لإشارة المخاطر.
                since:
                  type: string
                  format: date-time
                  description: الحد الأدنى الشامل. الافتراضي هو 30 يومًا قبل حتى.
                until:
                  type: string
                  format: date-time
                  description: >-
                    الحد الأعلى الحصري. الافتراضي هو وقت الطلب. النطاق الأقصى:
                    366 يومًا؛ يتم رفض النطاقات المستقبلية.
            example:
              format: json
              event_types:
                - signal
                - decision
      responses:
        '202':
          description: تم حفظ المهمة؛ استعلم عن export_id الخاص بها
          content:
            application/json:
              schema:
                type: object
                properties:
                  export_id:
                    type: string
                    format: uuid
                  status:
                    type: string
                    enum:
                      - pending
                      - running
                      - complete
                      - failed
                  format:
                    type: string
                    enum:
                      - json
                      - csv
                      - cef
                      - leef
                  since:
                    type: string
                    format: date-time
                  until:
                    type: string
                    format: date-time
                  event_types:
                    type: array
                    items:
                      type: string
                      enum:
                        - signal
                        - decision
                  record_count:
                    type: integer
                  created_at:
                    type: string
                    format: date-time
                  completed_at:
                    type: string
                    format: date-time
                  error_message:
                    type: string
                  export_data:
                    description: >-
                      دليل JSON المحلل لتنسيق json؛ نص لـ CSV و CEF و LEEF.
                      موجود فقط عند الاكتمال.
                    oneOf:
                      - type: object
                      - type: array
                        items: {}
                      - type: string
        '400':
          description: خيارات تصدير أو معرف غير صالح
        '401':
          description: المصادقة مطلوبة
        '503':
          description: التخزين أو المعالجة غير متاح؛ أعد محاولة معرف التصدير الحالي
      security:
        - APIKey: []
components:
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: مفتاح API للمصادقة من جهاز إلى جهاز
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT للعمليات التي يبدأها المستخدم

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.