تخطّي إلى المحتوى

ربط n8n بمفتاح API شخصي

تكتب عقدة n8n-nodes-marcomm المجتمعية البيانات الصحفية ومقالات المدونة والفعاليات الصحفية ودعوات RSVP، وتطلب الموافقة عليها وتنشرها. الحزمة لم تُنشر بعد.

  1. 1
    في Marcomm، انتقل إلى الإعدادات → التكاملات → n8n لترى الحالة والقيم التي تحتاجها.
    الإعدادات، التكاملات، n8n، مع الحالة وخطوات الاتصال والنطاقات المطلوب تحديدها وحالة الوصول إلى API
    تعرض صفحة n8n الحالة الحالية والخطوات والقيم المطلوب نسخها، وما إذا كان الوصول إلى API معتمدًا لمساحة العمل هذه.
  2. 2
    افتح الإعدادات → API. إذا لم يكن لمساحة العمل وصول إلى API بعد، يملأ المالك أو المسؤول التقدّم بطلب الوصول إلى API ويختار إرسال الطلب.
  3. 3
    بعد الموافقة، افتح إنشاء مفتاح، واختر مفتاح شخصي، وحدّد النطاقات التي تحتاجها، ثم اختر إنشاء المفتاح. انسخ المفتاح فورًا لأنه يظهر مرة واحدة فقط.
  4. 4
    في n8n Cloud، ابحث عن Marcomm AI في لوحة العقد (إن لم تظهر، فعّل Verified Community Nodes في لوحة الإدارة وأعد تشغيل النسخة). في n8n المستضاف ذاتيًا، افتح Settings (الإعدادات) ثم Community Nodes ثم Install (تثبيت)، وأدخل n8n-nodes-marcomm.
  5. 5
    أنشئ بيانات اعتماد Marcomm AI API، والصق المفتاح في API Key (مفتاح API)، ثم أضف العقدة Marcomm AI أو Marcomm AI Trigger إلى سير عمل.

تحتاج عقدة المشغّل إلى نطاق المحتوى ولا ترسل شيئًا في أول فحص، فلا تعيد تشغيل العناصر القديمة.

تغطي العقدة البيانات الصحفية ومقالات المدونة والفعاليات الصحفية ودعوات RSVP والموافقات، بما فيها الموافقة والرفض وقائمة الموافقات المعلّقة. تبدأ عقدة المشغّل سير العمل عند إنشاء بيان صحفي أو طلب الموافقة عليه أو نشره، وعند إنشاء مقالة مدونة أو نشرها، وعند إنشاء فعالية صحفية.

تحدّد النطاقات ما يستطيع المفتاح فعله. المحتوى (content) يقرأ البيانات الصحفية ومقالات المدونة والفعاليات الصحفية، وكتابة المحتوى (content:write) ينشئ المسودات ويعدّلها، والنشر والإرسال (distribution) ينشر ويرسل بالبريد الإلكتروني، والموافقات (approvals) يغطي خطوات الموافقة. تعمل النطاقات الثلاثة الأخيرة مع مفتاح شخصي فقط، لأن الإجراء يُسجَّل باسم من أنشأ المفتاح. أما مفتاح مساحة العمل فيقرأ فقط، وكل مفتاح يعمل بدور منشئه وصلاحياته.

لا يمكن التراجع عن النشر والإرسال. لا تنفّذهما API إلا إذا احتوى الطلب على confirm: true أو ترويسة Idempotency-Key، ولا تنشر شيئًا وتردّ بالرمز 409 ما دامت الموافقة مطلوبة أو كان المحتوى مجدولًا أو تحت حظر النشر. إعادة المحاولة بالمفتاح Idempotency-Key نفسه والطلب نفسه تعيد النتيجة الأولى لمدة 24 ساعة بدل التنفيذ مرة أخرى. ترسل العقدة مفتاح idempotency مع كل كتابة، مبنيًا من التنفيذ والعقدة والعنصر، وتؤكد عمليات النشر والإرسال بنفسها.

تتوفر API في خطة Team وما فوقها. يراجع فريق Marcomm AI كل طلب، ولا تعمل المفاتيح إلا بعد الموافقة. لا يستخدم المفتاح إلا النطاقات المعتمدة لمساحة العمل، ويمكن لكل شخص امتلاك 10 مفاتيح كحد أقصى. افتراضيًا يمكن لمساحة العمل إرسال 60 طلبًا في الدقيقة و10,000 طلب في اليوم، وبعد ذلك تردّ API بالرمز 429 مع ترويسة Retry-After. لرفع الحدود، استخدم تحتاج إلى حدود أعلى؟ في الإعدادات → API. لفصل n8n، اختر إلغاء بجانب المفتاح، فتفقد الأنظمة التي تستخدمه الوصول فورًا.

الأسئلة الشائعة

استدعِ GET https://marcomm.works/api/v1/me مع الترويسة Authorization: Bearer متبوعة بمفتاحك. يعمل ذلك مع أي مفتاح معتمد أيًا كانت نطاقاته، ويعيد مساحة العمل واسم المفتاح ونطاقاته.

لا يسجّل المفتاح الخدمة التي تستخدمه، لذلك لا يضع Marcomm علامة متصل على بطاقة n8n. تعرض الإعدادات → API آخر مرة استُخدم فيها كل مفتاح.

نعم، بعقدة HTTP Request المدمجة. استدعِ https://marcomm.works/api/v1 مع الترويسة Authorization: Bearer متبوعة بمفتاحك، وأضف ترويسة Idempotency-Key إلى كل كتابة.

التكاملات