دخولابدأ مجانًا
منصة المطورين · عام API · وصلات شبكية · موصلات

اجعل منصتك قابلة للتشغيل بالذكاء الاصطناعي.

استدعِ 2,430 عملية مسماة عبر واجهة API واحدة مولّدة من العقد، بنطاقات بأقل الصلاحيات وربط بمساحة العمل وتحقق تجريبي وكتابات آمنة عند إعادة المحاولة. اشترك في الأحداث القانونية عبر webhooks في الخلفية موقّعة بـ HMAC، أو ابنِ حزمة مُدارة في Connector Builder ذي الخطوات الست.

احصل على مفتاح API اقرأ الوثائق عقد مفتوح
مفاتيح Bearer المشمولة بالنطاقإجراءات العقد: 2,430OpenAPI 3.0.3+ Postmanتسليم Webhook بتوقيع HMAC
طلب النطاق
تم توقيع الويب هوك → 200 موافق
مباشر Bearer action → OpsIQ → signed webhook POST /api/v1.php الإذن: Bearer { "action": "التذكرة، الريبلي" "الدري" تحقق · تشغيل · تدقيق المفتاح + مساحة العمل ✓ النطاق + العقد✓ تم تتبع الطلب نقطة نهاية Webhook لديك X-OpsIQ-التذكرة، مستنسخة تحقق من HMAC → تعامل 200 حسنًا
2,430"اللواء"API الإجراءات
69النطاقات الأقل نموا
dry_runالتصديق على العقود قبل التنفيذ
24 ساعةإعادة كتابة ايديولوجية ناجحة
دورة حياة الطلب

طلب مُنْطَع حدث مُوقع

اتخاذ إجراء بشأن /api/v1.php بمفتاح Bearer محدد النطاق. يثبّت OpsIQ مساحة العمل، ويتحقق من عقد الإجراء والصلاحيات، ثم ينفذه أو يجربه تجريبياً. تخرج الأحداث القانونية المشترك بها عبر قائمة تسليم موقّعة بـ HMAC مع محاولات قابلة للتتبع وإعادة محاولات محدودة.

HMAC-SHA256 الويب هوكس - يتم توقيع الحمولة الواردة والصادرة على الجسم الخام؛ تستند مكالمات API إلى مفتاح Bearer محدد.
إعادة المحاولات التلقائية - عمليات التسليم الفاشلة تتراجع وتعيد المحاولة، مع معرف تسليم يمكنك تتبعه.
"السلامة المُتكررة" - كتب ايديبوتات ناجحة تعود نفس الرد 24 (ب) ساعات؛ وتتقاسم الازدواج المتزامن مطالبة واحدة.
تطبيقك POST /api/v1.php الإذن: Bearer الايدز: الإيديم - 31c7 تحقق - تشغيل - تدقيق نقطة النهاية الخاصة بك POST /webhooks تحقق من HMAC 200 حسنًا المفتاح + مساحة العمل مثبّتان نطاق + دور تم التحقق منه العقد المصادق عليه الإعدام أو الهروب الجاف تسليم Webhook موقّع { X-OpsIQ-Event:تذكرة مستنسخة X-OpsIQ-Delivery:الجزء الثاني X-OpsIQ-Timestamp: 1786584362 X-OpsIQ-Signature: 9c4e0a7b } تم التسليم
01 Bearer الطلب 02 تثبيت مساحة العمل 03 العقد المصادق عليه 04 الإعدام أو الهروب الجاف 05 حدث موقع
بدء سريع

من الأساسي إلى الإدماج المنظم ثلاث خطوات

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

العقودمتصل
GENERAL API تعاقدي مدفوع 1 · توليد المفتاح :: نطاق واحد Bearer المفتاح 2:: العقود السرية POST /api/v1.php · "العمليات" 3:: تقييم الكتابة تذاكر - جافة - 4 :: الاشتراك في الأحداث تذكرة مكررةHMACالإنجاز
تنفيذجافة→الكتابة المعتمدة، نفس العقد
01

احصل على مفتاح

سجل وولد مفتاح API من نوع Bearer محدد (opq_…) في إعدادات المطور، ومنح كل تكامل فقط الأسطح التي يحتاجها.

02

اكتشاف والتحقق

اقرأ meta.actions, meta.action و meta.scopes; Use dry_run لتأكيد الكتابة قبل الإعدام

03

الالتزام بالإنفاذ

أضف مفتاحاً للتكاتيف ثم نضمّ إلى آخر المستجدات التي تحتاجها

كيف يتناسب كل شيء معًا

نمط موصل واحد. خمسة بدائيات نظيفة.

أي شيء خاص بالمنصة يعيش في موصل. يبقى جوهر OpsIQ عامًا، يبقى الذكاء الاصطناعي متوقعًا، ويظل تكاملك قابلاً للمراجعة.

01
المشغلات

أخبر OpsIQ بما حدث للتو.

تقليد الأحداث الكانتونية من منصةكم، أو تحديد حدث محكوم بالعرف، ويتلقى المجندون الحدث من خلال قواعد الأولوية وقواعد التسليم المسجلة.

مرجع الحدث
invoice.paid حدث رادفي دماغ الذكاء الاصطناعيسياق مباشر القواعدالأولوية 20 مرآةاكتب أولاً ويب هوكموقعة
أحداث عالمية + مخصصةinvoice.paid, ticket.created, subscription.cancelled, customer.signed_up أو أنت مشتركون متفرعونيتفاعل دماغ الذكاء الاصطناعي، قواعد الأتمتة، الموصلات المرآة ونقاط نهاية webhook الخاصة بك. ترتيب الأولويةإرسال حتمي بحيث تكتب المرايا قبل أن تطلق التنبيهات.
02 / عقود الإجراءات

أخبر OpsIQ بما يُسمح للذكاء الاصطناعي بفعله.

وتتلقى كل عملية مسمّاة عقداً متولداً: النطاق، السمة، القراءة أو الكتابة، المخاطر، سياسة التثبيت، طلب الكيماويات والاستجابة لها، الدعم الجاف، الإيقاع بالأخطاء المستقرة.

مخطط العمل
لا يمكن للذكاء الاصطناعي اختراع إجراءاتيمكنه فقط الطلب لتشغيل ما قمت بتسجيله. سياسة التأكيدتؤدي الإجراءات المريبة إلى ظهور بطاقة المعاينة قبل أي تأثير جانبي. تقييد الدور + السطحكل إجراء يعلن عن الأدوار والأسطح المسموح لها بتنفيذه.
:: عقد عمل متولد؛ JSON
{
  "action": "tickets.reply",
  "kind": "write",
  "scopes": ["tickets.write", "admin"],
  "feature": "ticket_system",
  "risk": "medium",
  "confirmation": "recommended",
  "idempotency": "supported",
  "dry_run": true,
  "request": { "type": "object" },
  "response": { "required": ["success"] }
}
03 / Webhook موقّعة

ادفع الأحداث إلى مجموعتك - مع دليل تشفير.

اشترك بأي عنوان URL في أي من الأحداث القابلة للتسليم وعددها 53. يرسل OpsIQ حمولة JSON عبر POST موقّعة بـ HMAC-SHA256 على إصدار المخطط والطابع الزمني ومعرّف التسليم والمحتوى معًا، لا المحتوى وحده، حتى لا يمكن إعادة تشغيل تسليم الأمس ضدك اليوم.

حماية إعادة التشغيلمعرف التسليم القابل للتتبعتراجع تدريجي في 5 خطوات
مرجع Webhook
تحقق من webhook - php 
$raw = file_get_contents('php://input');
$sig = $_SERVER['HTTP_X_OPSIQ_SIGNATURE'] ?? '';   // "v2=<hex>"
$ts  = (int)($_SERVER['HTTP_X_OPSIQ_TIMESTAMP'] ?? 0);
$id  = (int)($_SERVER['HTTP_X_OPSIQ_DELIVERY'] ?? 0);

if (abs(time() - $ts) > 300) http_response_code(401);   // replay window
[$ver, $hex] = array_pad(explode('=', $sig, 2), 2, '');  // split the prefix

$signed   = $ver . '.' . $ts . '.' . $id . '.' . $raw;   // NOT the body alone
$expected = hash_hmac('sha256', $signed, $secret);
if (!hash_equals($expected, $hex)) http_response_code(401);

$event = json_decode($raw, true);   // $id is stable across retries
04 /مجموعات أدوات تطوير البرامجيات

استخدمي برنامج "هوتر بي" المباشر أو توليد العميل الذي تفضلينه

ألف - النطاق العام API نُشرت بوصفها OpenAPI. 3.0.3 و Postman:: تغطي برامج الإرسال المرجعية بلغة بي إتش بي بالإضافة إلى عملاء التكامل مع نود وبايتون تدفقات الأحداث الموقعة وتدفقات الوصلات الشبكية؛ ويمكن لأي كومة أن تستدعي نفس الشيء JSON مباشرة.

أمثلة العملاء
const response = await fetch(`${base}/api/v1.php`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.OPSIQ_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    action: "tickets.reply",
    dry_run: true,
    idempotency_key: crypto.randomUUID(),
    body: "Thanks. We are checking this now."
  })
});
$payload = json_encode([
  'action' => 'tickets.reply',
  'dry_run' => true,
  'idempotency_key' => bin2hex(random_bytes(16)),
  'body' => 'Thanks - we are checking this now.',
]);

$ch = curl_init($base . '/api/v1.php');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => $payload,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('OPSIQ_KEY'),
    'Content-Type: application/json',
  ],
]);
response = requests.post(
    f"{base}/api/v1.php",
    headers={
        "Authorization": f"Bearer {os.environ['OPSIQ_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "action": "tickets.reply",
        "dry_run": True,
        "idempotency_key": str(uuid.uuid4()),
        "body": "Thanks - we are checking this now.",
    },
)
مباشرة JSON HTTPOpenAPI3.0.3مجموعة Postmanمساعدو التكامل
05 / نمط الموصل

ابنِ مرة واحدة. قم بتوصيلها بأي شيء.

الموصل هو حزمة محكومة تولد أو يتم استيرادها من خلال الهوية، والتقصي، والاختبار، والعمل، والمتجرين، والاستعراض. OpsIQ مسموح له بالكشف

إفتحوا المبنى من ست مراحل
ست مراحل مسترشدةالهوية، والتوثيق، والاختبار، والأعمال، والمحركات، والمراجعة تجعل توليد الحزمة قابل للتفسير. العقود المدفوعةملفات التعريف (8) وأنواع القدرات (59) تعلن الأسطح التي تنفذها الحزمة. الإصداروتجرى عمليات التحقق من السلامة والمثبتات والتطابق قبل أن يُعامل الطرد على أنه جاهز.
من النية إلى الإجراء الآمن

اللغة الإنجليزية البسيطة في. عملية مدققة.

لا يخترع OpsIQ المكالمة الصحيحة. إنه يمر عبر العقود المسجلة، يحضر الحمولة، يطلب التأكيد عندما يتطلب الإجراء ذلك، وينتج صف تدقيق كامل عند التنفيذ، لذا فإن الذكاء الاصطناعي الذي يمكنه تصرف لا يصبح أبدًا ذكاءً اصطناعيًا لا يمكنك الوثوق به.

مقيد بالعقد. الذكاء الاصطناعي يقترح فقط الإجراءات التي قمت بتسجيلها.
تأكيد قبل الآثار الجانبية. تظهر الإجراءات المهددة بطاقة معاينة أولاً.
استعادة كاملة. كل مطالبة، رد ونتيجة إجراء تم التقاطها في تاريخ AI.
انظر مخطط الإجراء
4 خطواتنية → تدقيق
HMACموقع موقّع قبل التنفيذ
"استرداد فاتورة آدم الأخيرة" الخطوة 1 · حل النية → متطابق: saas.refund_invoice السطح: المسؤول · الدور: المالك · الخطوة 2 تحقق الخطوة 3 · تأكيد وتوقيع بطاقة المعاينة · الفاتورة #8421 تأكيد الخطوة 4 · صف التدقيق actor · prompt · result · 412ms للمالك فقط · قابل للتصدير كملف CSV
لا مكالمات مختلقةسجل العقد فقط
ابحث في جميع الوثائق...معاينة قبل الآثار الجانبية
الطلبالجهة الفاعلة + العقد + النتيجة
مرجع

واجهة API . بإلقاء نظرة

يوفّر سطح JSON POST واحد 2,430 إجراءً مسمّى. يعلن كل عقد مولّد عن نطاقات المصادقة ونوع القراءة/الكتابة والمخاطر والتأكيد ومخطط الطلب والتشغيل التجريبي وعدم التكرار والأخطاء المستقرة.

مرجع OpenAPI 3.0.3
إجراءالمصادقةكتابة السلامةالحد الأقصى
إجراءات الكتابةPOST /api/v1.php العقد المصادق عليه
ACTION tickets.replytickets.writeجاف - ركض + ايديالساعة
ACTION security.reportsecurity.writeجاف - ركض + ايديالساعة
ACTION platform.routes.writeمسؤولالتأكيد + المفتاحالساعة
قراءة & اكتشاف الإجراءاتنفس سطح الأرض المثبتة؛ مظاريف مستقرة
ACTION meta.actionsالاكتشافات العامةللقراءة فقطالساعة
ACTION tickets.listtickets.readللقراءة فقطالساعة
ACTION connectors.listconnectors.readللقراءة فقطالساعة
PeopleOS الإجراءات المتعلقة بالموارد البشريةملغومة hr.* العقود؛ hr.read / hr.write نطاقات
ACTION hr.people.listhr.readللقراءة فقطالساعة
ACTION hr.people.createhr.writeجاف - ركض + ايديالساعة
ACTION hr.org.treehr.readللقراءة فقطالساعة
PeopleOS لا ترسل HR أحداث webhook HR الخارجة. اذهب إليها من خلال نفس سطح POST، أو اشترك في الأحداث التي تنشرها النماذج الأخرى. المرجع الكامل: PeopleOS APIوالوصلات واللجنة اﻻقتصادية PeopleOS قسم مرجع المطورالوحدة مُبوَّبة للاستحقاقات، لذا مفتاح بدون hr تحصل على رفض، وليس قائمة فارغة. ماذا PeopleOS الموارد البشرية.

يتم تشكيل حدود المعدل لكل مفتاح على نافذة ساعة X-RateLimit-Limit, X-RateLimit-Remaining و X-RateLimit-Reset؛ يعود طلب مرفوض 429 مع Retry-After. استخدم عقد OpenAPI 3.0.3 أو مجموعة Postman متولدة من نفس السجلات

ابنِ موصلًا

البناء والاختبار والإفراج ست مراحل

ابدأ من ملف محكم أو تحدد العقد بنفسك، يقوم البناء بتصحيح كل مرحلة قبل أن يولد حزمة اتصال ذاتية الاحتواء.

1الهوية الاسم، اللفّة، الملامح و أسطح القدرات المعلن عنها
2وقتها API المفتاح، Bearer)أ( اﻷساسية، OAuth 2.0, HMAC أو عميل مخصص.
3اختبار. نقيم أماكن الاتصال المُقيدة قبل التغليف.
4الإجراءات خريطة تُسمى العمليات، والبارامترات، والنطاقات والمخاطر.
5مُتجرين نعلن الأحداث المُتقاربة، و الاختراع والسلوك المتزامن
6استعراض. تفقد العقد المولد و تمرر بوابة الإفراج
اختبر قبل الشحن

و نقيم بأمان ثم نعبر بوابة الإفراج

استخدم dry_run على أعمال الكتابة المدعومة، أجري اختبار الاتصال في المبنى وفحص المطبوعات والعقد المولدة قبل الإفراج

"الجرّاف يكتب" اختبار الاتصال الالتزام بالعقد الإنجاز القائم على أساس التسلسل الزمني
فتح Connector Builder مرجع Webhook
connector.php · php
فئة AcmeConnector يمتد AbstractConnector { وظيفة عامة سائل (اللوغ): سلسلة { عودة 'acme'; } وظيفة عامة الاسم (): سلسلة { عودة "أعني"; } وظيفة عامة الوصف (): سلسلة { عودة "جسر هام"; } // أسماء مستخدمة من عقد المؤتمرات وظيفة عامة (القدرات) مصفوفة { عودة ["العمليات", "ويب هوك"]; } وظيفة عامة البيئات: مصفوفة { عودة [['حسنا' => 'token', "نوع" => كلمة السر]]; } وظيفة عامة الاختبارمصفوفة $settings): مصفوفة { عودة ["النجاحات" => صحيح]; } وظيفة عامة (الجزء الأول) مصفوفة $payload, مصفوفة $headers, مصفوفة $settings ): مصفوفة { عودة ["النجاحات" => صحيح]; } }
01 · عقد الموصّل 2.7

لا يمكن لمجموعة من الطرود أن تطالب بالقدرة رمزها ليس لديه

OpsIQ\Connectors\ConnectorContract هي السلطة، الاكتشافات التي تجري في الوقت المناسب، البناء، مجموعات الأطراف الأولى، المطابقة العامة API وكل مرجع يقرأ سجل واحد، ويقرر القدرة وثلاثة ملفات يجب أن يتفق بعضها مع بعض قبل ذلك OpsIQ يُوجّه صف واحد إليك.

الشكل 01حزمة وصل، أجزاء المقياس 1:1 · العقد 2.7
  1. 01 connector.php درجة الجري
  2. 02 IdentityProvider.php مفتاح خارجي مستقر
  3. 03 SalesIngest.php التوفيق بين المبيعات
  4. 04 actions.json العمليات المسماة
  5. 05 settings.json تشكيلة المشغل
  6. 06 connector_contract.json السلطة القابلة للقراءة آليا
07 signature.json واحد HMAC على SHA-256 من كل ملف فوق، بالإضافة إلى دليل أصلي قدره 25519
مصفوفة القدرة جميعها وعددها 59، كما سُجّلت
الإجراءات المحفزات ويب هوك journey_events السياق guest_lookup الهوية sales sales_reconciliation الفوترة payments التجارة inbound_ticket outbound_reply ticket_merge ticket_custom_fields secure_details_request sync_users sync_departments sync_orders sync_products sync_projects customer_import security_events security_native_block survey reply_feedback promo_audience promo_feed email_mailbox inbound_email outbound_email mailbox ai_tickets ai_reply ai_brain_aware native_api platform_bridge native_data crm block_registry inbound_comment outbound_note outbound_notification oauth reviews محلي هذا site_intelligence محلل comms admin_assets enterprise_hooks durable_queue ticket_mirror attachment_bridge database_migrations scheduled_workers conflict_resolution
متولدة 32 إعلانية 20 التمديد 7
توقيعان، سؤالين

hmac-sha256 على حمولة محددة من كل قطعة256 إجابات هشة وقد تم تعديل هذا منذ التوقيع. أما ed25519 ردود التوقيع تم التوقيع عليها Nabtech، ويمكن التحقق منه بالمفتاح العام المرفق دون أي سر مشترك. عدِّل بايتًا واحدًا وسيتوقف الأول عن التطابق.

marketplace.json لا يوجد توقيع تعريف: يكتبه المُحرّر بعد التوقيع، لذا لم يكن بوسع الناشر أن يوقع عليه.
02 · الأدوات/التحويلات

حارس لم يفشل أبداً غير مُبرّر.

الإختبارات الخضراء لا تخبرك بشيء مفلس اليوم، ولا يخبرونك الحارس الذي كتبته سيوقف الشيء الذي كتب ليتوقف، لأن حارساً لم يمارس أبداً يمر تماماً مثل الحراس الذي لا يفعل شيئاً لذا نوقف قلبه عن قصد ونطالب بأن يصرخ الشاشة

:: يجب أن يرفض الدور الذي يقرأ العملية التدميرية CH1 ثاني أكسيد الكربون verify_commerce_contracts
src/Connectors/CommerceRoleMapVerifier.php مدمجة 
211    /* A read role must never reach a destructive operation. */
212-   if ($isRead && $isDestructive) {
212+   if (false) {
213        $errors[] = "read role '{$role}' points at a destructive op";
214        return false;
215    }
بالضبط واحد تطابق النص مطلوب، لا يوجد تطابق أو إثنين و الدليل يتوقف قبل أن يكذب
$ php tools/mutation_proof.php --spec=proofs.json 
1[ ok ]hash    sha256 4f2a9c1e…
          remember the file exactly as it is
2[ ok ]control exit 0
          green BEFORE anything is touched
3[ ok ]mutate  1 match, lint ok
          one replacement, then php -l the mutant
4[RED ]prove   exit 1
          and "read role destructive" IS in the failures
5[ ok ]restore bytes written
          the original, not a regenerated copy
6[ ok ]verify  sha256 matches
          and the check is green again
 ══ PROVEN. file restored, hash matched, 1 proof run, 0 failed.
دليل فاشل أبداً سجل، الدليل على أن الشيك قد أخطأ ليس دليلاً على عمل الحارس

الطفرة لم تطبق أبداً

لم يتطابق نص البحث، الملف كان غير ممسّك، ونجحت الدعوى، وسجل الدليل خضراء تحت الرمز القديم عن الشفرة التي لم تكن قديمة، تم القبض عليها بإشتراط مطابقة نصية واحدة ومقارنة ملف (هايلز) من كلا الجانبين.

الطفرة كسرت شيئاً آخر

الجناح ذهب أحمر لأن الملف توقف عن الفرز أو الحذاء مات، وسجلت الأدلة حمراء لا علاقة لها بالحرس أسمها اختبار بين الفشل

لا يمكن أن يترك متحولاً على قرص

كل عملية تطويع نسخ أصلية إلى سيارة جانبية خارج الشجرة التي تخدم الشبكة، تكتب علامة تسمي التغيير المعلق، وتُبطل بواسطة معالج مقفل على كل طريق خروج، ويشرف بعلامة من طائرة محطمة قبل التصفية التالية لذلك الملف.

03 الامتثال

الشهادة هي القيادة مع رمز خروج

ليست طابور مراجعة يقرأ فيه أحدهم شيفرتك ويكوّن رأيًا. شغّل مجموعات الاختبار نفسها التي نشغّلها، على جهازك، قبل الإرسال. مخططات JSON المنشورة (8) ضمن doc/contracts/schemas/ تغطي الإعدادات والإجراءات ومواصفات Builder وربط أحداث الرحلة والتجارة ووصفات سير العمل وعقود الموصّلات وبيانات الإصدار.

  1. manifests حزمة وتوافق مع بعضها البعض
  2. القدرات موجود في فصل الجري
  3. interfaces نفذت في الحالات التي أعلن فيها
  4. files كل ما يطلبه من ملفات
  5. الإجراءات تطابق الإجراءات
  6. destructive إعلان
  7. الهوية مفتاح خارجي مستقر، وليس بريد إلكتروني
  8. إعادة التشغيل تحديثات متكررة، لا تضاعف أبدا
  9. مؤسسة الإعلانات تتطابق مع التمديد
  10. الوثائق README، DEVELOPER، CHANGELOG
  11. الكيماويات كل شيء JSON المصادقة
مخرج 0 acme: conformant against contract 2.7 جناح فاشل يسمي الشيك والملف أنت تصلحه، وليس نحن
$ php tools/test_connector_conformance_all.php --connector=acme $ php tools/test_connector_json_schemas.php $ php tools/verify_commerce_contracts.php $ php tools/release_gate_connectors.php --require-signatures

نقطة الأولى في حساب غير إنتاجي حقيقي --live-settings=/secure/test-acme.jsonبينما أنت لا تزال تتهاوى، تبادل آخر واحد --unsigned-ok: يعامل التوقيع المفقود كتحذير متوقع بدلاً من التظاهر بأنه لا بأس به

04 · التجارة.json

تعلن ما يمكنك بيعه هو ملف، وليس تسجيل.

موصل يمكنه بيعه يعلن أي من الخاصة بها جواب العمليات OpsIQدور التجارة الكانتونية، وجود الملف هو الإدعاء، يظهر في أماكن البيع لحظة إعلانه واختفائه عندما يتوقف لا توجد قائمة للإنضمام ولا أحد يسأل

الدور الخفي commerce_roles.json عمليتك
catalog_search READ acme_search_products حسنا order_get READ acme_get_order حسنا order_create WRITE acme_create_order recovery: acme_get_order order_create WRITE db_insert_record سجل عام، لا يوجد تعافي
رفضت

"كانونية" أكتب التطابق هيكلي، ظهير تخزين بجانب شفرة متحولة، مهما كانت اتفاقية تسميتك، كتابة مسار العمل يتخطى مباشرة تسعير المنصّة، وفتح القفل وإقرار البريد، ويصدر أمراً بأن نظام التجار لا يؤمن به سوى نصفين. recovery و أيضاً، لذا فإنّ الوقت المُتَوَقَّد سيكون غير قابل للاسترداد.

commerce_roles.jsonمختارة
{
  "commerce": {
    "roles": {
      "catalog_search": { "operation": "acme_search_products", "transport": "http" },
      "order_get":      { "operation": "acme_get_order",       "transport": "http" },
      "order_create":   { "operation": "acme_create_order",    "transport": "http",
                         "recovery":  "acme_get_order" }
    }
  }
}
ملفها الخاص عن قصد: connector_contract.json وُلِدَتْ وأجهزتها الخاصة additionalProperties:false، لذا فإن أي كتلة مكتوبة يدويًا هناك ستفشل في التحقق ثم تُستبدل في التشغيل التالي للمولّد.
01
استفزازية مغلقة

دور لا يؤديه CommerceRole لا وجود له. OpsIQ لا يُستشف أبداً من اسم العملية لأن الاسم ليس وعداً

02
تصرفاتك الخاصة

يجب أن تظهر العملية في الخاص بك actions.json. فالتصريح بعملية غير موجودة يَعِد العميل بشيء لا ينتج عنه أي شيء.

03
تُعلن الشفاء

أكثر وقت مُخطّط هو الذي بعد المنصّة قد يكون قد قام بالعمل بدون نظرة "مُتطوّرة" على الأرض المكتوبة، الخيارات الوحيدة هي أن تُصبح أعمى أو تفقد الأمر.

04
أدوار السداد

ويعلن أيضاً أي دور من أدوار فئة المدفوعات payment_profile مع البيئة, webhook_verify باستخدام مخطط المزود الخاص، event_map. فالبيئة غير المُعلنة هي الطريقة التي يتلقى بها مزوّد في وضع الاختبار دفعة حقيقية.

المبني يصادق على هذه كما تطبع وتصدق على مجموعة الشحنات، كلاهما يدعو نفس المهام، لذا لا يمكن أن يختلفوا.
⚖️ كيف يقارن

OpsIQ مقابل a DIY integration.

ما تقدمه لك منصة موقعة ومراجعة وملزمة بالعقد لا يمكن أن تقدمه لك أدوات الويب الخاصة بك وعمليات الذكاء الاصطناعي.

القدرةقم بإنشاء خاصتكOpsIQ
النطاق Bearer API + Webhooks الموقعة من HMAC مُقيدة يدوياً ✓
"جرافي-رون" يكتب 24-أحسنت صنعاً DIY ✓
1m→5m→30m→ 2h → 12hالمقايضة صف القيام بنفسك ✓
سجل العقود من العمل (لا يمكن لـ (آي أي) أن يخترع المكالمات — ✓
سياسة التثبيت قبل التأثيرات الجانبية — ✓
مظروف الأخطاء المستقرة + طلب الهوية قطع الأشجار يدويا ✓
مباشرة HTTP + خيارات العميل المولدة أكتبي بنفسك ✓
OpenAPI 3.0.3 عقد قابل للقراءة آليا ربما ✓
بناء ست مراحل + بوابة إطلاق الرزم بناء مجموعة أدوات ✓
مفاتيح العمل ذات القاعدة الفضائية والحدود الزمنية للساعة يختلف ✓
نمط المحرك: رمز المنصات يبقى معزولا — ✓
الأسئلة الشائعة

أسئلة المطورين، تراجع

(ب) التوثيق، والعقود، وال retries، وتوليد العملاء، والاختبارات الآمنة ونموذج الاتصال قبل طلب الإنتاج الأول.

معلومات عامة API نداءات Authorization: Bearer opq_…. يمكن أن تكون المفاتيح غير مقيدة أو مقيدة أو للقراءة فقط، وتحمل نطاقات بالحد الأدنى من الصلاحيات، وتلتزم بحد للطلبات في الساعة، ويمكن تثبيتها على مساحة عمل. أما توقيع خطافات الويب فمنفصل: تحمل عمليات التسليم الصادرة X-OpsIQ-Signature, X-OpsIQ-Timestamp, X-OpsIQ-Event و X-OpsIQ-Delivery.
لا، لا يمكن للمبادرة أن تقترح عمليات محددة في سجل الإجراءات، وكل عقد منشئ يُعلن نطاقه ويطالب بمجالات معينة، ويُعنى بسياسة المخاطر والتأكيد؛ وتقتضي سياسة التحقق إجراء استعراض مسبق للإنسان قبل التنفيذ.
إعادة حساب hash_hmac('sha256', $rawBody, $secret) ومقارنة الهضمية بالهكسيد X-OpsIQ-Signature استخدام hash_equals. تحقّق من X-OpsIQ-Timestamp في نافذة إعادة تشغيلك و استخدام X-OpsIQ-Delivery كشخصية تحديد التوصيلات
ومحاولة غير ناجحة تدخل في إطار ترتيب تقديم المعلومات الأساسية. OpsIQ عمليات إعادة النظر على1-دقيقة 5-دقيقة 30-دقيقة2- ساعة و 12- سلم ساعة في الوقت الذي يحتفظ فيه بمحدد التوصيل ويحاول التاريخ للتشخيص.
إتصل بالشرطة JSON سطح العمل مباشرة، استيراد المولدة Postman مجموعة، أو توليد عميل من OpenAPI 3.0.3:: المرسلون المرجعيون للغة PHP وعملاء التكامل Node/Python يدعمون تدفقات الأحداث والروابط الشبكية؛ فهم مساعدون وليسوا منفصلين API العقود.
استخدم dry_run على الإجراءات التي يدعم عقدها المُنشأ ذلك، وشغّل اختبار الاتصال المحدود في Connector Builder، وافحص ملفاته المُنشأة، واجتز بوابات مطابقة الحزمة والإصدار قبل اعتبار الموصل جاهزًا.
الإطلاق المركب يولده API وعقود التوصيل من سجلاته الخاصة URL الأسرار، المخزن والزبائن/العمال لذا يجب التحقق من السلوك ضد الإطلاق الذي تم تركيبه بدلاً من الافتراض من بيئة سحابية
الموصل هو حزمة محكومة تحتوي على المكيّف settings.jsonاختياري actions.json:: عقد منشأ للقدرات، والوثائق وتمديد المشاريع الاختيارية - يجمّعها القائم على ست مراحل؛ ويكتشف السجل ذلك؛ ويثبت وجود بوابة تطابق وإطلاق.
منصة المطورين

اجعل منصتك قابل للتشغيل بواسطة الذكاء الاصطناعي.

انضم، وتولد مفتاح API ، ويكون لديك تكامل عامل في أقل من ساعة. هل تحتاج إلى مساعدة؟ سيقوم مهندسونا بمضاعفة معك على الفور.

ابدأ مجانًا تحدث إلى المبيعات