ARN Smart Support
اللغة: العربية

مفاتيح REST API وخطافات الويب الموقّعة (Pro)

تحديث 19 نوفمبر 2026 قراءة في 1 دقيقة
تصفح مقالات Contix

توفّر Contix Pro مفاتيح REST API محددة النطاق وخطافات ويب موقّعة، بحيث يمكن للأنظمة الأخرى بدء العمل في Contix ومعرفة وقت انتهائه. لا يعمل كلاهما إلا بعد أن ينشئهما مسؤول.

مكان العثور عليها: ARN Contix ← النظام ← التكاملات. اختر سياق المشروع في الأعلى وانقر على فتح مساحة عمل التكاملات. يُشرح اتصال Google Search Console الموجود في الشاشة نفسها في تتبّع الأداء باستخدام Google Search Console.

شاشة التكاملات في Contix تعرض نطاقات REST API واتصال Search Console وإعدادات خطافات الويب الموقّعة، دون عرض أي مفاتيح

إنشاء مفتاح REST API

  1. ضمن 1. مفاتيح REST API، أدخل الاسم.
  2. ضمن ربط المشروع، اختر كل المشاريع أو مشروعًا واحدًا. المفتاح المرتبط بمشروع واحد لا يعمل إلا مع الطلبات التي تحدد ذلك المشروع (project_id)، ولا يمكنه إنشاء مشاريع. يمكن للمفتاح المرتبط أيضًا استدعاء GET /status، ويعيد GET /projects مشروعه فقط.
  3. حدّد النطاقات التي يحتاجها المفتاح.
  4. انقر على إنشاء مفتاح API.

يُعرض المفتاح الجديد مرة واحدة فقط: انسخه فورًا واحفظه في مكان آمن. تخزّن Contix المفاتيح كقيم تجزئة مملّحة فقط ولا يمكنها عرض المفتاح مرة أخرى.

يعرض جدول المفاتيح الاسم والبادئة الخاصة بالمفتاح والنطاقات ووقت آخر استخدام للمفتاح. انقر على إلغاء لإيقاف مفتاح؛ إذ تُرفض الطلبات التي تستخدمه من ذلك الحين.

النطاقات ونقاط النهاية

تقع جميع نقاط النهاية ضمن /wp-json/contix/v1/. أرسل المفتاح في الترويسة Authorization بصيغة Bearer متبوعة بالمفتاح.

الطريقة ونقطة النهايةالنطاقالوظيفة
GET /statussystem.readيعيد إصدار Contix والمخطط وما إذا كان التشغيل متوقفًا مؤقتًا
GET /projectsprojects.readيعرض المشاريع؛ وللمفتاح المرتبط بمشروع واحد، ذلك المشروع فقط
POST /projectsprojects.writeينشئ مشروعًا (name، language، region، brand_summary، content_goal)
GET /projects/{project_id}/topicstopics.readيعرض مواضيع المشروع
POST /projects/{project_id}/topicstopics.writeينشئ موضوعًا (keyword، secondary_keywords، content_type، search_intent، audience، language، region، goal، priority)
POST /pipeline/startpipeline.writeيبدأ تشغيلًا (project_id، topic_id، mode بقيمة automatic أو guided)
GET /pipeline/{run_id}?project_id={project_id}pipeline.readيعيد حالة التشغيل
GET /projects/{project_id}/topics/{topic_id}/resultsresults.readيعيد النتائج المحفوظة لموضوع ما، مثل مسودة المقال والتحليل وحزمة النشر
GET /projects/{project_id}/jobsjobs.readيسرد المهام الأخيرة لمشروع ما
GET /projects/{project_id}/connectorsconnectors.readيسرد موصِّلات مشروع ما

يقتصر كل مفتاح على 120 طلبًا في الدقيقة. الاستجابات الشائعة:

الحالةالمعنى
401المفتاح مفقود أو غير صالح أو مُلغى
403المفتاح لا يمنح هذا النطاق، أو أنه مرتبط بمشروع آخر، أو حاول مفتاح مرتبط إنشاء مشروع
409تعذّر بدء التشغيل؛ وتوضّح الرسالة السبب
422تعذّر إنشاء المشروع أو الموضوع؛ تحقّق من الحقول
429تجاوز المفتاح 120 طلبًا في الدقيقة

يُسجَّل كل طلب موثَّق في سجل Contix.

إنشاء خطاف ويب موقَّع

  1. ضمن 3. خطافات الويب الموقّعة، أدخل الاسم ونقطة نهاية HTTPS.
  2. حدّد الأحداث التي تريدها: job.completed أو job.failed أو pipeline.completed أو pipeline.failed أو publish.completed أو publish.failed.
  3. انقر على إنشاء خطاف ويب.

يُعرض سرّ التوقيع مرة واحدة فقط: انسخه فورًا. لا تُقبل إلا عناوين HTTPS العامة؛ وتُرفض عناوين الشبكات الخاصة والمحجوزة.

يعرض جدول خطافات الويب الأحداث وعدد عمليات التسليم الناجحة والفاشلة وآخر حالة. انقر على حذف لإزالة خطاف ويب.

التحقق من تسليم خطاف الويب

يرسل Contix كل حدث كطلب POST بصيغة JSON مع هذه الترويسات:

الترويسةالمحتوى
X-Contix-Eventنوع الحدث، مثل pipeline.completed
X-Contix-Deliveryمعرّف تسليم ثابت؛ استخدمه لتجاهل أي تسليم عالجته من قبل
X-Contix-Timestampوقت التسليم كطابع زمني Unix
X-Contix-Signaturev1= متبوعًا بالتوقيع

التوقيع هو HMAC-SHA256 بالصيغة الست عشرية للطابع الزمني ثم نقطة ثم نص الطلب الخام (timestamp.body)، باستخدام سرّ التوقيع الخاص بك كمفتاح. احسبه من جهتك وقارنه بالترويسة قبل أن تثق بالطلب.

يُعدّ التسليم ناجحًا عندما تستجيب نقطة النهاية لديك بحالة 2xx. تُعاد محاولة أخطاء الشبكة والاستجابات ذات الحالة 429 أو 5xx عبر قائمة الانتظار. ولا تُتَّبع عمليات إعادة التوجيه.

مقالات ذات صلة

في هذه الصفحة

إرسال طلب

أنشئ طلب دعم جديدًا دون الحاجة إلى حساب.

الأولوية
المرفقات
لا يرى الطلب إلا أنت وفريقنا. لا ترسل كلمات المرور أو رموز الترخيص.

تتبع الطلب

استخدم رقم الطلب وكلمة المرور من رسالة التأكيد.

الرقم وكلمة المرور في رسالة التأكيد.

تسجيل الدخول

ادخل إلى حساب بوابة الدعم الخاص بك.

جديد هنا؟

إنشاء حساب

أنشئ حسابك في بوابة الدعم.

لديك حساب بالفعل؟

نسيت كلمة المرور؟

نرسل إليك رابطًا لاختيار كلمة مرور جديدة.

المحادثة

هل كان هذا مفيدًا؟
فتح المقالة كاملة
↑ ↓ للتنقلEnter للفتحEsc للإغلاق