n8n
سير عمل من أربع عقد: بيانات الميلاد كمدخل، خريطة فلكية من API في المنتصف، علامات الشمس والقمر والطالع كمخرج. تم استيراده إلى n8n 2.39.7 وتم تشغيله على بيئة الإنتاج في 2026-09-17، والنتيجة أدناه هي بالضبط ما أعاده.
عقدة AstroWay
Section titled “عقدة AstroWay”بدلاً من طلب HTTP اليدوي، يمكنك استخدام عقدة @astroway/n8n-nodes-astroway. تحتوي على 730 عملية API كإجراءات جاهزة مع حقول لـ: الخريطة الفلكية، التوافق الفلكي، العبور الفلكي، علم الفلك الفيدي، التصميم البشري، با زي، علم الأعداد، التارو وغيرها.
- في n8n المستضاف ذاتيًا، افتح الإعدادات ← عقد المجتمع ← تثبيت، أدخل
@astroway/n8n-nodes-astrowayوقم بالتأكيد. قام n8n بالتحقق من العقدة في 2026-10-23، لذا في n8n Cloud، يمكنك إضافتها من لوحة العقد دون أي تثبيت. - أنشئ بيانات اعتماد AstroWay API والصق المفتاح. يتحقق n8n منه باستخدام طلب
GET /v1/auth/keys/meوالذي لا يستهلك أرصدة. إذا كان للمفتاح نطاق نقاط نهاية، أضفauth/keys/meإليه، وإلا ستظهر رسالةForbiddenعند التحقق، على الرغم من أن الاستدعاءات ضمن النطاق ستعمل. - أضف عقدة AstroWay، اختر المجموعة والعملية، على سبيل المثال Core → Natal Chart. الحقول الإلزامية موجودة بالفعل في القائمة، وتضاف الحقول الاختيارية عبر إضافة حقل.
تعيد العقدة جزء data من الاستجابة، وخطأ برمز API، على سبيل المثال INVALID_INPUT. يمكن توصيلها بوكيل AI كأداة.
أدناه نفس الحساب بدون العقدة، باستخدام طلب HTTP عادي. يعمل في أي n8n، بما في ذلك Cloud.
أولاً، أنشئ مفتاحًا، كما هو موضح في قسم مفتاح الأتمتة، بنطاق chart.
1. أضف المفتاح كبيانات اعتماد
Section titled “1. أضف المفتاح كبيانات اعتماد”يتم تخزين المفتاح في مخزن بيانات اعتماد n8n، وليس في العقدة، لذا لا يتم تضمينه في سير العمل المُصدّر.
- أنشئ بيانات اعتماد جديدة في n8n من نوع Header Auth.
- الاسم:
X-Api-Key. - القيمة: مفتاحك.
- احفظه بالاسم AstroWay API key. يبحث سير العمل أدناه عن بيانات الاعتماد بهذا الاسم تحديدًا.
2. استورد سير العمل
Section titled “2. استورد سير العمل”قم بتنزيل n8n-natal-chart.json، افتح سير عمل فارغًا والصق محتوى الملف على اللوحة أو استخدم استيراد من ملف في قائمة سير العمل.
يوجد بالداخل أربع عقد:
- Start، عقدة Manual Trigger: تشغل سير العمل أثناء الاختبار.
- Birth data، عقدة Edit Fields (Set):
date،time،timezone،latitudeوlongitudeلشخص واحد. - AstroWay chart، عقدة HTTP Request: تستدعي
POST /v1/chart. - Big three، عقدة Edit Fields (Set): تحول خطوط الطول إلى أسماء علامات.
3. شغّل
Section titled “3. شغّل”نفّذ سير العمل. تعيد Big three:
{ "sun": "Taurus", "moon": "Capricorn", "rising": "Virgo", "offset_used": 4}offset_used هو الإزاحة عن التوقيت العالمي المنسق (UTC) التي وجدها الخادم لـ Europe/Kyiv في 1990-05-15: 4، وليس 3، التي تُكتب يدويًا عادةً.
كيف تم إعداد عقدة HTTP Request
Section titled “كيف تم إعداد عقدة HTTP Request”-
الأسلوب:
POST. -
عنوان URL:
https://api.astroway.info/v1/chart -
المصادقة: نوع بيانات اعتماد عام.
-
نوع المصادقة العام: Header Auth، بيانات اعتماد AstroWay API key.
-
إرسال الجسم: مفعّل.
-
نوع محتوى الجسم: JSON.
-
تحديد الجسم: استخدام JSON.
يتم تحديد الجسم بواسطة تعبير، لذا يتم تمرير القيم من أي عقدة سابقة كما هي:
{{ JSON.stringify({ date: $json.date, time: $json.time, timezone: $json.timezone, latitude: $json.latitude, longitude: $json.longitude }) }}كيف تُحسب العلامات
Section titled “كيف تُحسب العلامات”كل حقل في Big three هو تعبير. العلامة تساوي خط الطول مقسومًا على 30 ومقربًا للأسفل، كفهرس في القائمة:
{{ ['Aries','Taurus','Gemini','Cancer','Leo','Virgo','Libra','Scorpio','Sagittarius','Capricorn','Aquarius','Pisces'][Math.floor($json.data.houses.ascendant / 30)] }}بالنسبة للشمس والقمر، يتم أخذ خط الطول من $json.data.planets.find(p => p.name === 'Sun').longitude وبالمثل من 'Moon'.
أدخل بياناتك
Section titled “أدخل بياناتك”استبدل Start و Birth data بالمشغل الذي تستخدمه بالفعل: سواء كان نموذجًا، أو webhook، أو صفًا جديدًا في جدول، وقم بمطابقة حقوله مع الأسماء الخمسة المذكورة أعلاه. هناك أمران يجب التحقق منهما:
timezoneلا يمكن أن يكون فارغًا. يتم رفض القيمة الفارغة برمز400، لذا قم بمطابقة الحقل أو عيّنautoإذا كانت الإحداثيات موثوقة.- الإحداثيات إلزامية. استدعاء الخريطة لا يقوم بتحويل اسم المدينة إلى إحداثيات جغرافية؛ إذا كان النموذج يطلب المكان فقط، أضف قبل AstroWay chart طلب HTTP إلى
GET /v1/geo/search?q=...وخذlatitudeوlongitudeوtimezoneمن النتيجة الأولى (البحث عن الأماكن؛ أضفgeo/searchإلى نطاق المفتاح).