Skip to main content
POST
التحقق من صحة Webhook الخاص بـ Monitor

التفويضات

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

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

الجسم

application/json
destination_config
object
مطلوب

ضبط الوجهة. لـ webhook: يتطلب webhook_url (نص)، وheaders (كائن) وbody (كائن) اختياريان. للبريد الإلكتروني: يقبل email (نص) أو emails (مصفوفة نصوص). للتسلسلات: يتطلب sequence_identifier (نص) بالإضافة إلى واحد على الأقل من is_people_search_enrolled / is_company_contact_enrolled مضبوطًا على true.

مثال:
monitor_id
string<uuid>

المعرّف الفريد لـ Monitor موجود لاختباره. اختياري لاختبار ضبطات جديدة.

name
string

اسم الـ Monitor.

description
string

وصف الـ Monitor.

detection_mode
enum<string>

كيفية اكتشاف الإشارات. يفحص signal_first السوق بشكل واسع؛ ويتتبع company_first قائمة حسابات مسمّاة ويتطلب شركة واحدة على الأقل، أو نطاقًا، أو رابط LinkedIn. غير قابل للتغيير بعد الإنشاء — تغييره في Monitor موجود يُعيد 40021. أنشئ Monitor جديدًا بدلًا من ذلك.

الخيارات المتاحة:
company_first,
signal_first
signal_types
enum<string>[]

أنواع الإشارات المراد مراقبتها.

الخيارات المتاحة:
jobs,
news,
advertisements,
expansions
signal_filters
object[]

إدخال واحد لكل دفق إشارة يراقبه الـ Monitor.

مثال:
company_filters
object

مرشحات شركة عامة. تقبل نفس معاملات نقطة Company Search.

مثال:
companies
string<uuid>[]

قائمة معرّفات domain_search_id (UUID) للشركات. البديل: استخدم domains أو linkedin_urls.

domains
string[]

قائمة نطاقات الشركات. بديل لـ companies.

linkedin_urls
string<uri>[]

قائمة روابط شركات على LinkedIn. بديل لـ companies.

is_company_enrichment
boolean

ما إذا كان سيتم إثراء بيانات الشركة.

is_people_enrichment
boolean

ما إذا كان سيتم إثراء بيانات الأشخاص.

people_enrichment_configs
object[]

مصفوفة من طبقات إثراء الأشخاص. تحتوي max_people_to_return (1-25)، وpeople_contact_types (انظر Redeem)، وfilters (انظر People Search).

مثال:
destination_type
enum<string>

نوع وجهة التسليم.

الخيارات المتاحة:
webhook,
email,
sequences
frequency_minute
integer

وتيرة التفعيل بالدقائق. الأدنى: 0، الأقصى: 10080.

النطاق المطلوب: 0 <= x <= 10080
max_failure_trigger
integer

الحد الأقصى للإخفاقات المتتالية قبل الإيقاف المؤقت. الأدنى: 1، الأقصى: 10.

النطاق المطلوب: 1 <= x <= 10
max_daily_trigger
integer

الحد الأقصى للتفعيلات يوميًا. الأدنى: 0، الأقصى: 86400.

النطاق المطلوب: 0 <= x <= 86400
max_records_per_trigger
integer

يتحكم في الحد الأقصى لعدد السجلات المُسلَّمة لكل تفعيل. القيم الأقل تقلل حجم الحمولة لكل تسليم، وهو موصى به لمجموعات النتائج الكبيرة أو التكاملات المحدودة المعدل. الأدنى: 1، الأقصى: 100، الافتراضي: 25. راجع إعداد Webhooks للإرشاد.

النطاق المطلوب: 1 <= x <= 100
notification_email
string<email>

البريد الإلكتروني لإشعارات الإخفاق.

max_retry_per_trigger
integer

الحد الأقصى لإعادة المحاولات لكل تفعيل. الأدنى: 0، الأقصى: 3.

النطاق المطلوب: 0 <= x <= 3
retry_delay_second
integer

التأخير بين إعادة المحاولات بالثواني. الأدنى: 1، الأقصى: 5.

النطاق المطلوب: 1 <= x <= 5

الاستجابة

استجابة ناجحة تحتوي على نتائج التحقق من webhook — ضبط الوجهة وحمولتي طلب/استجابة الاختبار. عند إخفاق webhook تستجيب النقطة الطرفية بـ400 (MONITOR_WEBHOOK_URL_INVALID) مع استجابة webhook في تفاصيل الخطأ.

data
object