تخطَّ إلى المحتوى
AstroWay/api v2.356.2 · ar
جميع الأنظمة تعمل بشكل طبيعي

n8n

Last updated عرض بصيغة Markdown إعداد الوكيل

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

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

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

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

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

أولاً، أنشئ مفتاحًا، كما هو موضح في قسم مفتاح الأتمتة، بنطاق chart.

1. أضف المفتاح كبيانات اعتماد

Section titled “1. أضف المفتاح كبيانات اعتماد”

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

  1. أنشئ بيانات اعتماد جديدة في n8n من نوع Header Auth.
  2. الاسم: X-Api-Key.
  3. القيمة: مفتاحك.
  4. احفظه بالاسم AstroWay API key. يبحث سير العمل أدناه عن بيانات الاعتماد بهذا الاسم تحديدًا.

قم بتنزيل 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): تحول خطوط الطول إلى أسماء علامات.

نفّذ سير العمل. تعيد 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 }) }}

كل حقل في 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 إذا كانت الإحداثيات موثوقة.
  • الإحداثيات إلزامية. استدعاء الخريطة لا يقوم بتحويل اسم المدينة إلى إحداثيات جغرافية؛ إذا كان النموذج يطلب المكان فقط، أضف قبل AstroWay chart طلب HTTP إلى GET /v1/geo/search?q=... وخذ latitude و longitude و timezone من النتيجة الأولى (البحث عن الأماكن؛ أضف geo/search إلى نطاق المفتاح).