دليل إرشادي

مسار n8n — الجزء 1: فهم العقد والتدفقات الأساسية

تعلّم أساسيات n8n من العقد والتدفقات والتعبيرات لبناء أتمتة بسيطة وفعّالة.

10 دقائق قراءة Automation

مقدمة في n8n وعقدة HTTP Request

تعتبر n8n من أقوى منصات الأتمتة المفتوحة المصدر. بينما توفر المنصة مئات العقد (Nodes) الجاهزة لتطبيقات شهيرة، ستواجه حتماً لحظة تحتاج فيها للاتصال بخدمة لا يوجد لها عقدة رسمية بعد. هنا تبرز أهمية عقدة HTTP Request، التي تمثل الجسر العالمي للتواصل مع أي واجهة برمجة تطبيقات (API) في العالم.

إعداد طلب HTTP أساسي

لاستخدام العقدة بنجاح، يجب أن تفهم مكونات الطلب الأساسية:

Method (النوع): GET لجلب البيانات، POST لإرسال بيانات جديدة، PUT/PATCH للتعديل، و DELETE للحذف.
URL (الرابط): مسار الـ API الذي ترغب بالتواصل معه.
Headers (الترويسات): ضرورية لتحديد نوع البيانات (مثل Content-Type: application/json) أو لتمرير الرموز الأمنية.
Body (الجسم): البيانات المرسلة (تستخدم عادة مع POST و PUT).

إعداد المصادقة عبر OAuth2

العديد من واجهات الـ APIs الحديثة تتطلب مصادقة (OAuth2) بدلاً من مفتاح API ثابت. لحسن الحظ، n8n يدعم هذا بروعة:

في إعدادات عقدة HTTP Request، ابحث عن قسم Authentication.
اختر Generic Credential Type ثم OAuth2 API.
ستحتاج إلى إنشاء بيانات اعتماد (Credential) جديدة. سيطلب منك n8n إدخال Client ID و Client Secret، وروابط التفويض (Authorization URL) والرمز (Token URL) التي توفرها الخدمة الخارجية.
بمجرد حفظ الإعدادات، سيظهر زر (Connect)، والذي سينقلك لتسجيل الدخول للخدمة ومنح الصلاحيات. سيتولى n8n مهمة تجديد الرمز (Token Refresh) تلقائياً مستقبلاً!

التعامل مع الترقيم (Pagination)

إذا كنت تجلب قائمة مستخدمين أو مقالات، فلن ترسل الـ API جميع النتائج في طلب واحد بل ستقسمها لصفحات. في n8n:

في عقدة HTTP Request، قم بتفعيل خيار Pagination.
حدد نوع الترقيم الذي تدعمه الـ API (مثل Page Number أو Cursor/Next URL).
سيقوم n8n بطلب الصفحات تباعاً حتى يصل للحد الأقصى الذي حددته، أو حتى ينتهي المحتوى، ليعيد لك قائمة واحدة مدمجة يسهل معالجتها في العقد التالية.

استراتيجيات التعامل مع الأخطاء (Error Handling)

الـ APIs تتعطل، أو تفرض حدوداً على عدد الطلبات (Rate Limiting). إذا لم تتعامل مع الأخطاء، سيتوقف سير العمل بأكمله.

إعادة المحاولة (Retries): في إعدادات العقدة، فعل Retry on Fail. حدد عدد المحاولات (مثلاً 3) ووقت الانتظار بينها. هذا ممتاز لتجاوز الأخطاء المؤقتة للشبكة.
متابعة العمل عند الفشل (Continue On Fail): في تبويب الإعدادات المتقدمة (Settings) الخاص بالعقدة، يمكنك تفعيل Continue On Fail. إذا فشل الطلب، سيُمرر n8n رسالة الخطأ للعقدة التالية بدلاً من إيقاف المسار. يمكنك حينها استخدام عقدة (If) للتحقق مما إذا كان هناك خطأ، وإرسال تنبيه عبر Telegram لفريق الدعم، ثم إنهاء المسار بسلام.

الخلاصة

احتراف عقدة HTTP Request في n8n ينقلك من مستخدم عادي للمنصة إلى مهندس أتمتة متقدم. بفهمك للمصادقة، الترقيم، وإدارة الأخطاء، لم يعد هناك نظام أو خدمة على الإنترنت لا يمكنك ربطها بمشاريع منظمتك.