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

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