Skip to main content
POST
البحث في البصمة السحابية للشركات

التفويضات

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

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

الجسم

application/json
providers
string[]

اقتصر على السجلات المطابقة لهذه مزوّدي السحابة أو الاستضافة. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

مثال:
exclude_providers
string[]

استبعد السجلات المطابقة لهذه مزوّدي السحابة أو الاستضافة. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

مثال:
target_locations
string[]

رموز الدول التي يجب أن تستهدفها النتائج. تُدمج مع filter_conditions بـ OR افتراضيًا — تكفي مطابقة أي منها.

مثال:
exclude_target_locations
string[]

رموز الدول التي يجب ألا تستهدفها النتائج. تُدمج مع filter_conditions بـ OR افتراضيًا — تكفي مطابقة أي منها.

مثال:
cloud_regions
string[]

اقتصر على السجلات المطابقة لهذه المناطق السحابية. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

مثال:
exclude_cloud_regions
string[]

استبعد السجلات المطابقة لهذه المناطق السحابية. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

مثال:
cities
string[]

اقتصر على السجلات المطابقة لهذه المدن. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

مثال:
exclude_cities
string[]

استبعد السجلات المطابقة لهذه المدن. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

مثال:
first_seen_dates
(string | null)[]

تاريخان بصيغة ISO 8601 (YYYY-MM-DD) يحددان فترة أول رصد لها البصمة. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

Required array length: 2 elements
مثال:
last_seen_dates
(string | null)[]

تاريخان بصيغة ISO 8601 (YYYY-MM-DD) يحددان فترة آخر رصد لها البصمة. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

Required array length: 2 elements
مثال:
is_cross_border_only
boolean

عند التفعيل تُعاد السجلات خارج السوق المحلية للشركة فقط. تُستبعد سجلات الشركات مجهولة المقر.

مثال:

true

host_count
(integer | null)[]

الحد الأدنى والأقصى لـ المضيفات. استخدم null لترك أحد الحدين مفتوحًا. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

Required array length: 2 elements
مثال:
server_count
(integer | null)[]

الحد الأدنى والأقصى لـ الخوادم (عناوين IP مميزة). استخدم null لترك أحد الحدين مفتوحًا. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

Required array length: 2 elements
مثال:
shared_server_count
(integer | null)[]

الحد الأدنى والأقصى لـ الخوادم المشتركة مع شركات أخرى. استخدم null لترك أحد الحدين مفتوحًا. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

Required array length: 2 elements
مثال:
region_count
(integer | null)[]

الحد الأدنى والأقصى لـ المناطق السحابية. استخدم null لترك أحد الحدين مفتوحًا. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

Required array length: 2 elements
مثال:
city_count
(integer | null)[]

الحد الأدنى والأقصى لـ المدن. استخدم null لترك أحد الحدين مفتوحًا. يقتصر على سجل البصمة هذا — مزوّد واحد في دولة واحدة.

Required array length: 2 elements
مثال:
cloud_footprint_host_count
(integer | null)[]

الحد الأدنى والأقصى لـ المضيفات. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_server_count
(integer | null)[]

الحد الأدنى والأقصى لـ الخوادم (عناوين IP مميزة). استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_shared_server_count
(integer | null)[]

الحد الأدنى والأقصى لـ الخوادم المشتركة مع شركات أخرى. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_provider_count
(integer | null)[]

الحد الأدنى والأقصى لـ المزوّدين المختلفين لدى الشركة. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_country_count
(integer | null)[]

الحد الأدنى والأقصى لـ الدول التي تستضيف بها الشركة. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_cross_border_country_count
(integer | null)[]

الحد الأدنى والأقصى لـ الدول خارج السوق المحلية للشركة. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_region_count
(integer | null)[]

الحد الأدنى والأقصى لـ المناطق السحابية. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
cloud_footprint_city_count
(integer | null)[]

الحد الأدنى والأقصى لـ المدن. استخدم null لترك أحد الحدين مفتوحًا. يُحتسب على مستوى الشركة ككل، عبر كل المزوّدين والدول.

Required array length: 2 elements
مثال:
company_locations
string[]

موقع مقر الشركة. راجع نقاط location تحت تبويب Filters لمزيد من المعلومات.

مثال:
cloud_footprint_id
string<uuid>

معرّف سجل بصمة سحابية واحد.

مثال:

"f28215e6-f6ed-40c2-ac9b-d8e70164c0be"

cloud_footprint_ids
string<uuid>[]

معرّفات سجلات بصمة سحابية محددة لتصديرها.

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

قائمة من معرّفات فريدة (domain_search_id) تُستخدَم لعمليات البحث عن شركات وأشخاص.

domains
string[]

قائمة نطاقات شركات تُستخدَم لعمليات البحث عن شركات وأشخاص. إن استلمنا رابطًا مثل www.pubrio.com أو https://docs.pubrio.com/، سيحوّله النظام إلى pubrio.com للمعالجة.

مثال:
per_page
integer
افتراضي:25

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

النطاق المطلوب: x <= 25
مثال:

25

page
integer
افتراضي:1

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

مثال:

1

is_ascending_order
boolean
افتراضي:false

اتجاه الترتيب. تُعاد النتائج بترتيب الأحدث أولًا افتراضيًا؛ اضبط true للأقدم أولًا. لا يوجد sort_by في هذه النقطة الطرفية — مفتاح الترتيب ثابت ومذكور في وصف النقطة الطرفية.

مثال:

false

cloud_footprint_providers
string[]

الشركات التي تستخدم أيًا من هؤلاء المزوّدين في أي مكان. providers بدون بادئة يضيّق السجلات، وهذا يضيّق الشركات.

مثال:
cloud_footprint_target_locations
string[]

الشركات الموجودة في أي من هذه الدول ضمن أي جزء من بصمتها.

مثال:
cloud_footprint_primary_provider
string[]

الشركات التي يكون أكبر مزوّد لديها أحد هؤلاء.

مثال:
domain
string

نطاق شركة يُستخدَم لعمليات البحث عن شركات. إن استلمنا رابطًا مثل www.pubrio.com أو https://docs.pubrio.com/، سيحوّله النظام إلى pubrio.com للمعالجة.

مثال:

"pubrio.com"

domain_search_id
string<uuid>

معرّف فريد لعملية البحث عن شركات.

linkedin_urls
string[]

الرابط الكامل لملف شركة على LinkedIn. يبدأ الرابط بـhttp ويحتوي linkedin.com/company/

مثال:
filter_conditions
object[]

يبدّل مرشّح المصفوفة من OR (الافتراضي: مطابقة أي قيمة) إلى AND (مطابقة كل القيم). ينطبق على cloud_regions وexclude_cloud_regions وcities وexclude_cities.

الاستجابة

سجلات بصمة سحابية مقسّمة إلى صفحات.

The response is of type object.

آخر تعديل في ٤ سبتمبر ٢٠٢٦