اجعل منصتك قابلة للتشغيل بالذكاء الاصطناعي.
التحليلات والتقارير
طلب في. تم توقيع webhook.
تقوم بإرسال POST إلى واجهة برمجة التطبيقات OpsIQ باستخدام مفتاح Bearer الخاص بك. تتحقق OpsIQ من النطاق والدور، وتنفذ الإجراء المتعاقد عليه، وتكتب صف تدقيق - ثم تطلق webhook موقعة بـ HMAC مرة أخرى إلى نقطة النهاية الخاصة بك. كل قفزة موثقة، غير قابلة للتكرار وتُعاد عند الفشل.
من الصفر إلى تكامل مباشر في أربع خطوات.
قم بإنشاء مفتاح، أطلق أول حدث لك، اشترك في webhook، سجل إجراء. يمكنك تشغيل الحلقة بالكامل ضد البيئة التجريبية قبل لمس بيانات الإنتاج.
احصل على مفتاح
سجل وولد مفتاح API من نوع Bearer محدد (opq_…) في إعدادات المطور، ومنح كل تكامل فقط الأسطح التي يحتاجها.
اشترك واطلب
)توقيع( events/fire (أو استخدم SDK)، ثم وجه أي عنوان URL إلى أي حدث، موقع، مع معرف تسليم وإعادة محاولات.
سجل إجراء
أعلن عن عقد إجراء موقّع حتى يتمكن الذكاء الاصطناعي من تشغيل العمليات بأمان، مع فحوصات الدور، سياسة التأكيد ومسار تدقيق كامل.
نمط موصل واحد. خمسة بدائيات نظيفة.
أي شيء خاص بالمنصة يعيش في موصل. يبقى جوهر OpsIQ عامًا، يبقى الذكاء الاصطناعي متوقعًا، ويظل تكاملك قابلاً للمراجعة.
أخبر OpsIQ بما حدث للتو.
أطلق أحداث عالمية من منصتك - أو أسماء أحداث مخصصة خاصة بك. يتفاعل كل مشترك في الوقت الفعلي، بترتيب الأولوية.
مرجع الحدثinvoice.paid, ticket.created, subscription.cancelled, customer.signed_up أو أنت
مشتركون متفرعونيتفاعل دماغ الذكاء الاصطناعي، قواعد الأتمتة، الموصلات المرآة ونقاط نهاية webhook الخاصة بك.
ترتيب الأولويةإرسال حتمي بحيث تكتب المرايا قبل أن تطلق التنبيهات.
أخبر OpsIQ بما يُسمح للذكاء الاصطناعي بفعله.
عقد العمل هو إعلان JSON موقع: ما يفعله الإجراء، أي الأدوار يمكنها تشغيله، ما المعلمات التي يقبلها، ما إذا كان التأكيد مطلوبًا، ونقطة النهاية التي يجب الاتصال بها.
مخطط العمل{
"key": "saas.refund_invoice",
"label": "Refund a paid invoice",
"surface": ["admin"],
"roles": ["owner", "billing_admin"],
"requires_confirmation": true,
"params": {
"invoice_id": { "type": "int", "required": true },
"reason": { "type": "string", "max": 500 }
},
"endpoint": "https://api.you.com/refund",
"audit": true
}
ادفع الأحداث إلى مجموعتك - مع دليل تشفير.
اشترك في أي عنوان URL لأي حدث. يقوم OpsIQ بإرسال الحمولة JSON الموقعة بـ HMAC-SHA256 عبر الجسم الخام - تحقق منها في بضع أسطر.
$raw = file_get_contents('php://input');
$sig = $_SERVER['HTTP_X_OPSIQ_SIGNATURE'] ?? '';
$expected = hash_hmac('sha256', $raw, $secret); // hex digest, no prefix
if (!hash_equals($expected, $sig)) http_response_code(401);
$event = json_decode($raw, true);
عملاء جاهزين للغة التي تستخدمها بالفعل.
ثلاثة SDKs رسمية تتعامل مع المصادقة، التوقيع، إعادة المحاولة، مفاتيح التكرار والاستجابات المخصصة. أو ابقَ بدون إطار - كل SDK هو غلاف رقيق حول نفس واجهة REST.
import { OpsIQ } from "@opsiq/sdk";
const ops = new OpsIQ({ apiKey: process.env.OPSIQ_KEY });
await ops.events.fire("order.shipped", {
customer_id: 421,
order_ref: "NB-9182",
carrier: "DHL"
});
const result = await ops.actions.run("saas.send_kb_link", {
ticket_id: 5519,
article: "how-to-reset-password"
});
use OpsIQ\Client;
$ops = new Client([
'api_key' => getenv('OPSIQ_KEY'),
]);
$ops->events->fire('order.shipped', [
'customer_id' => 421,
'order_ref' => 'NB-9182',
]);
$result = $ops->actions->run('saas.send_kb_link', [
'ticket_id' => 5519,
'article' => 'how-to-reset-password',
]);
from opsiq import OpsIQ
ops = OpsIQ(
api_key=os.environ["OPSIQ_KEY"],
)
ops.events.fire("order.shipped", {
"customer_id": 421,
"order_ref": "NB-9182",
})
result = ops.actions.run("saas.send_kb_link", {
"ticket_id": 5519,
"article": "how-to-reset-password",
})
ابنِ مرة واحدة. قم بتوصيلها بأي شيء.
الموصل هو مجلد يحتوي على فئة PHP واحدة. يكتشف OpsIQ ذلك، وتقوم السجل بتوصيل الأحداث، ويظل كودك الخاص بالمنصة مفصولًا بشكل نظيف عن النواة.
دليل الموصلidentityProviders(), contextProviders(), registerActions(), subscribers(), handleWebhook().
مدفوع بالبياناتactions.json و settings.json إعلان العقود والإعداد.
تم اكتشافه تلقائيًاقم بإسقاط المجلد، وقم بتوقيعه، وقم بتمكينه في الإدارة.
اللغة الإنجليزية البسيطة في. عملية مدققة.
لا يخترع OpsIQ المكالمة الصحيحة. إنه يمر عبر العقود المسجلة، يحضر الحمولة، يطلب التأكيد عندما يتطلب الإجراء ذلك، وينتج صف تدقيق كامل عند التنفيذ، لذا فإن الذكاء الاصطناعي الذي يمكنه تصرف لا يصبح أبدًا ذكاءً اصطناعيًا لا يمكنك الوثوق به.
واجهة API . بإلقاء نظرة
كل نقطة نهاية أساسية، مصادقتها، عدم التكرار وحدود المعدل لكل مفتاح. العقد الكامل القابل للقراءة آليًا موجود في مرجع OpenAPI 3.0.3.
POST /v1/events/fireمركز الاتصالات الهاتفيةنعم1000 / دقيقةPOST /v1/actions/runمركز الاتصالات الهاتفيةنعم200 / دقيقةPOST /v1/webhooks/testمركز الاتصالات الهاتفيةنعم60 / دقيقةGET /v1/customers/{id}مركز الاتصالات الهاتفيةنعم2000 / دقيقةGET /v1/ticketsمركز الاتصالات الهاتفيةنعم2000 / دقيقةGET /v1/connectorsمركز الاتصالات الهاتفيةنعم2000 / دقيقةتكون حدود المعدل لكل مفتاح وتُعاد في كل استجابة كـ X-OpsIQ-RateLimit-Remainingالأحداث الصادرة 429 مع Retry-After رأس. العقد الكامل القابل للقراءة آليًا (كل نقطة نهاية، مخطط وخطأ) موجود في مرجع OpenAPI 3.0.3.
شحن موصل في خمسة خطوات.
الموصل هو مجلد مستقل. يكتشف OpsIQ ذلك، ويسجل السجل الأحداث، ولا يتسرب كودك المحدد للمنصة إلى النواة.
connector.php تمديد AbstractConnector.actions.json و settings.json تظهر.مفتاح صندوق الرمل ومختبر ويب هوك.
كل مساحة عمل تعرض صندوق رمل: مفتاح منفصل محدد يصل إلى نفس واجهة برمجة التطبيقات دون لمس بيانات الإنتاج. استخدم POST /v1/webhooks/test لتفعيل تسليم عينة موقعة عند نقطة النهاية الخاصة بك وتأكيد تحقق توقيعك قبل الذهاب مباشرة. التثبيتات المستضافة ذاتيًا تعمل بنفس مسار الكود، دون انحراف سلوكي بين السحابة والمحلي.
OpsIQ مقابل a 10- التكامل بالعمل الذاتي.
ما تقدمه لك منصة موقعة ومراجعة وملزمة بالعقد لا يمكن أن تقدمه لك أدوات الويب الخاصة بك وعمليات الذكاء الاصطناعي.
| القدرة | قم بإنشاء خاصتك | OpsIQ |
|---|---|---|
| HMAC-signed requests & webhooks (both ways) | Hand-rolled | ✓ |
| Idempotency keys + replay protection | DIY | ✓ |
| Automatic back-off retries with delivery IDs | DIY queue | ✓ |
| Action-contract registry (AI can't invent calls) | — | ✓ |
| Confirmation policy before side-effects | — | ✓ |
| 100% audit-log coverage on actions | Manual logging | ✓ |
| Official PHP / Node / Python SDKs | Write your own | ✓ |
| OpenAPI 3.0.3 machine-readable contract | Maybe | ✓ |
| Sandbox keys + webhook tester | Build a staging rig | ✓ |
| Cloud & self-hosted parity (same code path) | يختلف | ✓ |
| Connector pattern: platform code stays isolated | — | ✓ |
أسئلة المطورين، تراجع
المصادقة، التوقيعات، SDKs، sandboxing ونموذج الموصل: كل ما ستسأل عنه قبل الطلب الأول.
Authorization: Bearer opq_…. تتحقق OpsIQ من نطاق المفتاح ودور الفاعل قبل تشغيل أي شيء. تعتبر Webhooks منفصلة: كل webhook ترسله OpsIQ يحمل X-OpsIQ-Signature (تجزئة HMAC-SHA256 للهيئة الخام) و X-OpsIQ-Timestamp لحماية إعادة التشغيل، حتى تتمكن من التحقق منا في المقابل، وwebhooks الواردة التي ترسلها يتم التحقق منها بنفس الطريقة.requires_confirmation يظهر بطاقة معاينة لإنسان قبل تشغيل الأثر الجانبي.hash_hmac('sha256', $rawBody, $secret) (هضم سداسي بدون بادئة) ومقارنته بـ X-OpsIQ-Signature رأس مع تحقق في وقت ثابت (hash_equals). تحمل كل عملية تسليم أيضًا طابع زمني، ومفتاح عدم التكرار ومعرف تسليم يمكنك تتبعه. قطعة PHP على هذه الصفحة هي التحقق الكامل.POST /v1/webhooks/test لإطلاق تسليم عينة موقعة إلى نقطة النهاية الخاصة بك وتأكيد التحقق الخاص بك قبل الذهاب مباشرة.AbstractConnector, بالإضافة إلى actions.json و settings.json الاستوديو، الكتل التفاعلية المتميزة، ميزات الذكاء الاصطناعي ووضع HTML المخصص يتم التحكم فيها بوضوح حسب الخطة، مع حد لكل خطة على عدد الحملات. يكون التحكم افتراضيًا متساهلاً: يتم حظرك فقط من الميزات التي لا تتضمنها خطتك. identityProviders(), contextProviders(), registerActions(), subscribers() و handleWebhook(). يقوم OpsIQ باكتشافه تلقائيًا، ويربط الأحداث ويحافظ على كودك المحدد للنظام الأساسي مفصولًا بشكل نظيف عن النواة.