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

# محاولة معالجة Monitor

> شغّل Monitor محفوظًا حسب المعرّف، أو شغّل ضبطًا مخصصًا غير محفوظ بتمرير الضبط ضمن الطلب؛ مع monitor_id، تتجاوز الحقول المضمَّنة الـ Monitor المحفوظ لهذه التشغيلة.



## OpenAPI

````yaml ar-openapi POST /monitors/process/try
openapi: 3.0.0
info:
  description: >-
    تقدّم واجهة Pubrio API معلومات استخباراتية عن توسع السوق — إشارات في الوقت
    الفعلي تُعلِم عندما تدخل شركة سوقًا جديدة — إلى جانب بيانات الشركات والأشخاص
    التي تستند إليها. ابحث، وتحقق، وأثرِ الحسابات وجهات التواصل، واشترك في
    إشارات تحرك مصنَّفة ومؤرَّخة عبر أكثر من 200 سوق.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/ar/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/ar/get-in-touch
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.pubrio.com
security:
  - pubrio_api_key: []
tags:
  - name: Profile
    description: معلومات ملف مساحة العمل وإحصاءات الاستخدام
  - name: Enrichment
    description: إثراء سجلات الأشخاص والشركات ببيانات B2B مفصّلة
  - name: Lookalike
    description: إيجاد شركات مشابهة لشركة معينة
  - name: Search
    description: البحث عن أشخاص وشركات ووظائف وأخبار وإعلانات بمرشحات
  - name: Lookup
    description: البحث عن معلومات مفصّلة لأشخاص وشركات ووظائف وأخبار وإعلانات وتقنيات محددة
  - name: LinkedIn
    description: البحث عن بيانات أشخاص وشركات عبر روابط ملفات LinkedIn
  - name: Redeem
    description: استبدال أرصدة لفتح بيانات تواصل الأشخاص (فردي ودفعي)
  - name: Channels
    description: إدارة قوالب قنوات التواصل (إنشاء، تحديث، حذف، سرد)
  - name: Monitor
    description: إنشاء وإدارة Monitors للبيانات بواجهات webhook، وإحصاءات، ومعالجة
  - name: Filters
    description: >-
      استرجاع قيم المرشحات المتاحة لمعاملات البحث (التقنيات، المواقع، القطاعات،
      إلخ)
  - name: API Keys
    description: سرد وفحص سجلات طلبات API وتحليلات الاستخدام لمفاتيح API
  - name: Insights
    description: رؤى إشارات مجمَّعة للشركات (الوظائف، الأخبار، الإعلانات).
  - name: Export
    description: تصدير بيانات دفعي (مقيَّد بالأرصدة).
  - name: Expansion
    description: >-
      معلومات استخباراتية عن توسع الشركات في السوق: الإشارات، المراحل، الأسواق،
      والتصدير.
externalDocs:
  description: >-
    The Pubrio API is used to search, preview and enrich Contacts and Accounts.
    Pubrio database provides extensive B2B contacts and sales intelligence data.
  url: https://docs.pubrio.com
paths:
  /monitors/process/try:
    post:
      tags:
        - Monitor
      summary: محاولة معالجة Monitor
      description: >-
        شغّل Monitor محفوظًا حسب المعرّف، أو شغّل ضبطًا مخصصًا غير محفوظ بتمرير
        الضبط ضمن الطلب؛ مع monitor_id، تتجاوز الحقول المضمَّنة الـ Monitor
        المحفوظ لهذه التشغيلة.
      operationId: monitors_process_try
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                monitor_id:
                  type: string
                  format: uuid
                  description: >-
                    اختياري. المعرّف الفريد لـ Monitor محفوظ لتفعيله. اتركه
                    فارغًا لتشغيل ضبط مخصص غير محفوظ ممرَّر ضمن الطلب.
                tried_at:
                  type: string
                  format: date-time
                  description: >-
                    الطابع الزمني المُستخدَم كنقطة مرجعية للفحص. استخدم تاريخًا
                    ماضيًا قريبًا لضمان توفر البيانات للاختبار. قد يُعيد استخدام
                    الوقت الحالي 0 نتائج.
                name:
                  type: string
                  description: اسم ضبط التشغيلة.
                detection_mode:
                  type: string
                  enum:
                    - company_first
                    - signal_first
                  description: وضع الاكتشاف للتشغيلة.
                signal_types:
                  type: array
                  items:
                    type: string
                  description: >-
                    أنواع الإشارات المراد فحصها (jobs، news، advertisements،
                    expansions).
                signal_filters:
                  type: array
                  items:
                    type: object
                  description: كائنات مرشحات لكل نوع إشارة، بنفس شكل Create Monitor.
                company_filters:
                  type: object
                  description: مرشحات شركة عامة، بنفس معاملات Company Search.
                companies:
                  type: array
                  items:
                    type: string
                    format: uuid
                  description: معرّفات domain_search_id (UUID) للشركات المراد فحصها.
                domains:
                  type: array
                  items:
                    type: string
                  description: نطاقات الشركات المراد فحصها — تُحل إلى شركات.
                linkedin_urls:
                  type: array
                  items:
                    type: string
                    format: uri
                  description: روابط شركات على LinkedIn المراد فحصها — تُحل إلى شركات.
                is_company_enrichment:
                  type: boolean
                  description: ما إذا كان سيتم إثراء بيانات الشركة في النتائج.
                is_people_enrichment:
                  type: boolean
                  description: ما إذا كان سيتم إثراء بيانات الأشخاص في النتائج.
                people_enrichment_configs:
                  type: array
                  items:
                    type: object
                  description: طبقات إثراء الأشخاص، بنفس شكل Create Monitor.
                destination_type:
                  type: string
                  enum:
                    - webhook
                    - email
                    - sequences
                  description: نوع وجهة التسليم للتشغيلة.
                destination_config:
                  type: object
                  description: ضبط الوجهة للتشغيلة، بنفس شكل Create Monitor.
                max_records_per_trigger:
                  type: integer
                  description: الحد الأقصى للسجلات المُسلَّمة بهذه التشغيلة.
      responses:
        '200':
          description: استجابة ناجحة تحتوي على نتائج تنفيذ التفعيل.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      monitor_id:
                        type: string
                        format: uuid
                        description: معرّف الـ Monitor الذي تم تفعيله.
                      status:
                        type: string
                        description: حالة تنفيذ التفعيل.
                      total_signals:
                        type: integer
                        description: العدد الإجمالي للإشارات المكتشَفة.
                      total_credit:
                        type: integer
                        description: إجمالي الأرصدة المستهلَكة.
                      processing_time_ms:
                        type: integer
                        description: إجمالي وقت المعالجة بالمللي ثانية.
                      delivery_result:
                        type: object
                        properties:
                          is_success:
                            type: boolean
                            description: ما إذا نجح التسليم.
                          error_message:
                            type: string
                            nullable: true
                            description: رسالة الخطأ إن فشل التسليم.
                          response_status_code:
                            type: integer
                            description: رمز حالة HTTP من الوجهة.
                          response_payload:
                            type: string
                            description: نص الاستجابة من الوجهة.
                          retry_attempt:
                            type: integer
                            description: رقم محاولة إعادة المحاولة.
                        description: تفاصيل نتيجة التسليم.
              example:
                data:
                  monitor_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                  status: success
                  total_signals: 25
                  total_credit: 59
                  processing_time_ms: 99050
                  delivery_result:
                    is_success: true
                    error_message: null
                    response_status_code: 200
                    response_payload: OK
                    retry_attempt: 0
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  responses:
    general_error:
      description: >-
        طلب غير صحيح. كان الطلب مُصاغًا بشكل خاطئ أو يحتوي معاملات غير صالحة.
        تحقق من رمز الخطأ والرسالة للتفاصيل.
      content:
        application/json:
          schema:
            required:
              - code
              - message
              - details
            type: object
            properties:
              code:
                example: 40001
                type: integer
              message:
                example: >-
                  Errors and codes will vary depending on the scenario, please
                  see the documentation for information.
                type: string
              details:
                type: object
    rate_limit_error:
      description: >-
        تم تجاوز حد المعدل. نُفِّذت طلبات كثيرة جدًا خلال فترة زمنية معينة. أعِد
        المحاولة بعد إعادة ضبط نافذة حد المعدل.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: Request rate limit exceeded. Please wait and try again later.
                type: string
    server_error:
      description: >-
        خطأ خادم داخلي. حدث خطأ غير متوقع في الخادم. تواصل مع الدعم إن استمر
        الخطأ.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: An unexpected error occurred on the server.
                type: string
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        رمز API فريد يمثّل الإجراءات التي تنفّذها عبر الواجهة والصلاحيات
        والعمليات المقابلة. يمكنك إنشاءه عبر قسم
        [Settings](https://dashboard.pubrio.com/#/settings/).
      in: header

````