n8n

Last updated 6 نوفمبر 2026 عرض بصيغة Markdown إعداد الوكيل

Workflow مكوّن من أربعة عقد: في المدخل بيانات الميلاد، في الوسط خريطة فلكية من API، في المخرج علامات الشمس، القمر والطلوع. تم استيراده إلى n8n 2.39.7 وتشغيله ضد الإنتاج في 2026-09-17، والنتيجة أدناه هي نفسها التي أعادها.

عقدة AstroWay

بدلاً من طلب HTTP يدوي يمكنك وضع عقدة @astroway/n8n-nodes-astroway. تحتوي على 730 عملية API كإجراءات جاهزة مع الحقول: الخريطة الفلكية، السيناستري، العبور، الفلك الهندي، Human Design، BaZi، علم الأعداد، التارو وغيرها.

في n8n المستضاف ذاتيًا افتح Settings → Community Nodes → Install، أدخل @astroway/n8n-nodes-astroway وأكد. تحقّق n8n من العقدة في 2026-10-23، لذا يمكنك في n8n Cloud إضافتها من لوحة العقد دون تثبيت أي شيء.
أنشئ credential AstroWay API وأدخل المفتاح. يتحقق n8n منه عبر طلب GET /v1/auth/keys/me، الذي لا يستهلك أي ائتمانات. إذا كان للمفتاح نطاق نقاط النهاية، أضف إليه auth/keys/me، وإلا ستظهر نتيجة التحقق Forbidden، رغم أن المكالمات من النطاق ستعمل.
أضف عقدة AstroWay، اختر المجموعة والعملية، مثل Core → Natal Chart. الحقول الإلزامية موجودة بالفعل في القائمة، ويمكن إضافة غير الإلزامية عبر Add field.

العقدة تُعيد جزءًا من data في الاستجابة، وخطأ برمز API مثل INVALID_INPUT. يمكن ربطها بـ AI Agent كأداة.

في الأسفل نفس الحساب بدون العقدة، باستخدام طلب HTTP عادي. يعمل في أي n8n، بما في ذلك Cloud.

أولاً أنشئ مفتاحًا كما هو موضح في القسم Ключ для автоматизації، مع نطاق chart.

1. أضف المفتاح كـ credential

المفتاح يُحفظ في مخزن credentials في n8n، وليس في العقدة، لذا لا يُدرج في سير العمل المُصدّر.

أنشئ في n8n credential جديد من النوع Header Auth.
Name: X-Api-Key.
Value: مفتاحك.
احفظه بالاسم AstroWay API key. سير العمل أدناه يبحث عن credential بهذا الاسم.

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. شغّل

نفّذ سير العمل. Big three تُعيد:

{
  "sun": "Taurus",
  "moon": "Capricorn",
  "rising": "Virgo",
  "offset_used": 4
}

offset_used هو الإزاحة عن UTC التي وجدها الخادم لـ Europe/Kyiv في 1990-05-15: 4، وليس 3 كما يُكتب عادةً يدويًا.

كيفية إعداد عقدة HTTP Request

Method: POST.
URL:
```
https://api.astroway.info/v1/chart
```
Authentication: Generic Credential Type.
Generic Auth Type: Header Auth, credential AstroWay API key.
Send Body: مفعّل.
Body Content Type: JSON.
Specify Body: Using JSON.

الجسم مُحدد بتعبير، لذا تُنقل القيم من أي عقدة سابقة كما هي:

{{ JSON.stringify({ date: $json.date, time: $json.time, timezone: $json.timezone, latitude: $json.latitude, longitude: $json.longitude }) }}

كيفية حساب العلامات

كل حقل في 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'.

أدخل بياناتك

استبدل Start و Birth data بالمُشغّل الذي تستخدمه فعليًا: نموذج، webhook أو صف جديد في جدول، وربط حقوله بخمس أسماء أعلاه. هناك أمران يجب التحقق منهما:

timezone لا يمكن أن يكون فارغًا. القيمة الفارغة تُرفض بـ 400، لذا اربط الحقل أو ضع auto إذا كانت الإحداثيات موثوقة.
الإحداثيات إلزامية. API لا تقوم بجيوكود اسم المدينة؛ إذا كان النموذج يطلب المكان فقط، أضف خطوة جيوكود قبل AstroWay chart.