Skip to main content
POST
سرد سجلات إحصاءات Monitor

التفويضات

pubrio-api-key
string
header
مطلوب

رمز API فريد يمثّل الإجراءات التي تنفّذها عبر الواجهة والصلاحيات والعمليات المقابلة. يمكنك إنشاءه عبر قسم Settings.

الجسم

application/json
monitor_id
string<uuid>

المعرّف الفريد للـ Monitor المراد استرجاع سجلاته.

monitor_ids
string<uuid>[]

التصفية إلى سجلات هذه الـ Monitors.

monitor_log_ids
string<uuid>[]

التصفية إلى إدخالات السجل المحددة هذه.

search_term
string

عبارة بحث تُطابَق مقابل error_message وdestination_type وdetection_mode (سلسلة فرعية غير حساسة لحالة الأحرف).

start_date
string<date>

بداية نطاق تاريخ created_at (سلسلة تاريخ ISO). تُستخدم مع end_date.

end_date
string<date>

نهاية نطاق تاريخ created_at (سلسلة تاريخ ISO). تُستخدم مع start_date.

order_by
enum<string>
افتراضي:created_at

الحقل المُستخدَم للترتيب. القيمة الافتراضية created_at.

الخيارات المتاحة:
created_at,
total_credit,
processing_time_ms,
total_signals,
status,
retry_attempt
is_ascending_order
boolean
افتراضي:false

الترتيب تصاعديًا. القيمة الافتراضية false (تنازلي).

statuses
string[]

التصفية حسب حالة التفعيل (مثل 'success'، 'failure'). تقبل أيضًا القيمة الوهمية 'recovered' — التفعيلات الفاشلة التي نجحت إعادة محاولتها لاحقًا.

signal_types
string[]

التصفية إلى السجلات التي تتضمن أنواع إشاراتها أيًا من هذه القيم.

destination_types
string[]

التصفية حسب أنواع الوجهات (مثل ['email', 'webhook']).

detection_modes
string[]

التصفية حسب أوضاع الاكتشاف (مثل ['company_first', 'signal_first']).

per_page
integer
افتراضي:25

السجلات لكل صفحة. القيمة الافتراضية 25، وهي أيضًا السقف في معظم الخطط — الحد هو max_search_per_page الخاص باشتراكك، الذي تُعيده Profile. تجاوزه يُعيد HTTP 416 برمز 41676 (أو 41613 في بحث الشركات والأشخاص)، لا مجموعة نتائج مقتطَعة.

page
integer
افتراضي:1

رقم الصفحة، بدءًا من 1. السقف هو max_search_page الخاص باشتراكك (max_company_search_page لبحث الشركات)، الذي تُعيده Profile. تجاوزه يُعيد HTTP 416.

الاستجابة

استجابة ناجحة. الغلاف هو { metadata: { filters }, data: { pagination, monitor_logs } } — تعرض metadata.filters المرشحات التي طُبِّقت على البحث.

metadata
object
data
object