التكاملات

افتح مركز Integrations في Admin Panel لربط EventHub وموصلات مستودع البيانات وAPI Console. التوفر يعتمد على الخطة والنشر.

Integrations في Admin Panel هو المكان الذي يربط فيه المسؤولون PetroBench بأنظمة بيانات الشركة ويفتحون API Console للمنظمة.

واجهة Admin Panel هذه قيد النشر وقد لا تظهر في كل منظمة بعد. عند تفعيلها لخطتك، ستجدها تحت Admin Panel > API & Integrations. أدلة الإعداد التفصيلية في Enterprise Integrations.

فتح Integrations

انتقل إلى Admin Panel
افتح API & Integrations > Overview (قد تظهر التسمية Integrations)
راجع الموصلات المميزة وقوائم الفئات (Oil & Gas، Cloud & Data، Identity & Access، ومجموعات ذات صلة)

يعرض المركز الإجماليات للتكاملات المتاحة والمتصلة عندما يكون لمنظمتك وصول.

ما تديره هنا

المجال	الغرض
Connector catalog	تصفح التكاملات المتاحة لمنظمتك
Connection status	معرفة الموصلات المفعّلة أو قريبًا
EventHub	فتح إعداد المزامنة والسجلات لاتصال مستودع نشط
API Console	Service Tokens وwebhooks والاستخدام وإعدادات الاتصال

مفاتيح API الشخصية ما زالت تحت Settings. مركز Admin Panel هو واجهة المطور على مستوى المنظمة.

EventHub ومزامنة المستودع

لـ EventHub و Snowflake وسير عمل المزامنة ذات الصلة، استخدم أدلة Enterprise:

من Admin Panel عادةً:

افتح بطاقة التكامل المتصل
راجع تعيين الحقول وجدول المزامنة وسجلات المزامنة الأخيرة
حل مراجعات مطابقة المعدات عندما يضع الموصل مطابقات منخفضة الثقة في قائمة الانتظار

مطابقات المعدات منخفضة الثقة من المزامنة الواردة تُنتظر لمراجعة المسؤول حتى لا يحصل المهندسون صامتًا على وحدة ضخ أو درجة قضيب خاطئة.

وحدة تحكم API

API Console هو مركز API للمنظمة داخل التطبيق. افتح Admin Panel > API & Integrations > API Console.

يتضمن أربعة تبويبات:

التبويب	الغرض
Service Tokens	إنشاء وإدارة رموز مملوكة للقسم للخوادم والمهام
Webhooks	تسجيل نقاط HTTP لأحداث المنصة
Usage	حجم الطلبات المباشر وحدود الخطة والحصص الشهرية
Connect	إعداد جاهز للنسخ لـ CLI وعملاء MCP و REST

Usage

Usage يعرض حجم طلبات API والحصص واستهلاك الرموز للفترة الحالية.

تتضمن البطاقات النموذجية:

عدد طلبات المنظمة والشخصية، متوسط وقت الاستجابة، ومعدل الخطأ
Plan limits - طلبات في الدقيقة، إجمالي القسم، تشغيلات متزامنة، سقف الرموز اليومي
Monthly quotas - قراءات، كتابات، تشغيلات محاكاة، وتسليمات webhook
Daily activity بالإضافة إلى أهم النقاط والمستهلكين عند وجود حركة

استخدم هذا التبويب عند تشخيص حدود المعدل أو ضغط الحصص أو أخطاء API غير المتوقعة. راجع أيضًا Rate limits.

Service Tokens

Service Tokens هي بيانات اعتماد طويلة الأمد مملوكة للقسم، وليس لشخص. تستمر بالعمل بعد مغادرة المنشئ.

إنشاء service token

انتقل إلى Admin Panel > API & Integrations > API Console
افتح تبويب Service Tokens
انقر Create service token
أدخل Token name (مثل Nightly Snowflake Sync)
اختر Expiration (30 يومًا، 90 يومًا، أو سنة)
اضبط IP allowlist اختياريًا
اختر Permissions (نطاقات) لـ Wells و Simulations و Equipment و Organization
انقر Create service token
انسخ الرمز النصي فورًا - يُعرض مرة واحدة فقط

من قائمة الصف يمكنك إعادة التسمية أو التدوير أو الإلغاء. لكل قسم عدد محدود من الرموز النشطة (يُعرض كمستخدم من الإجمالي في القائمة).

فضّل service tokens للمهام المجدولة والتكاملات. فضّل personal API keys فقط عندما يستدعي مهندس واحد API تفاعليًا.

تفاصيل المصادقة الكاملة: API authentication.

Webhooks

Webhooks تسجّل نقاط HTTP يستدعيها PetroBench عند وقوع أحداث (مثل well.created أو simulation.failed).

افتح تبويب Webhooks
انقر Add Webhook
أدخل URL النقطة واختر الأحداث
احفظ، ثم استخدم عنصر الإرسال/الاختبار للتحقق من التسليم

Connect

تبويب Connect يساعدك على توجيه CLI وعملاء MCP (Claude، ChatGPT، Cursor) أو cURL أو Python إلى مساحة عملك. انسخ الإعداد لعميلك، ثم استبدل placeholder مفتاح API بـ service token أو مفتاح شخصي.

لإعداد العميل خطوة بخطوة، راجع Getting started و MCP reference.

من يصل

الإجراء	HQ Admin	Division Admin	Region Admin
عرض مركز Integrations	نعم	يختلف حسب الخطة	لا
ضبط EventHub	نعم	يختلف حسب الخطة	لا
فتح API Console (Usage، Connect)	نعم	نعم (قسمه)	لا
إدارة Service Tokens	نعم	نعم (قسمه)	لا
إدارة Webhooks	نعم	نعم (قسمه)	لا

التكاملات

في هذه الصفحة