استخدام Narwhal API مع n8n API

يمكنك استخدام n8n مع Narwhal API لسحب الإجازات الرسمية ومواعيد الإصدار والبيانات الاقتصادية والسلع وأسعار الصرف واحتمالات أسواق التنبؤ إلى سير عمل. تجلب عقدة HTTP Request البيانات بمفتاح API، ويمكن لعقدة Schedule Trigger بدء سير العمل على فترات زمنية.

ما الذي ستعدّه

يربط n8n بين عقد سير العمل، ويمنحك هذا الإعداد طلب بيانات يمكنه تغذية وجهة مثل جدول أو بريد إلكتروني. ستخزّن مفتاح Narwhal API في بيانات اعتماد، وتضبط عقدة HTTP Request للبيانات التي تريدها، وتقسّم قائمة الاستجابة إلى عنصر لكل صف. يتشارك REST وMCP المفتاح نفسه، لذا تستخدم طلبات n8n المفتاح ذاته الذي تستخدمه هاتان الواجهتان.

اضبط مفتاح API الخاص بك

  1. أنشئ مفتاحًا مجانيًا أنشئ حسابك على narwhalapi.com/signup واحصل على مفتاح API مجاني. يستخدم Narwhal API حسابًا واحدًا ومفتاحًا واحدًا لجميع واجهات البيانات، لذا استخدم هذا المفتاح لكل مجال تربطه في n8n.
  2. تخزين المفتاح احتفظ بالمفتاح في متغير بيئة اسمه NARWHAL_API_KEY. عند إعداد بيانات اعتماد n8n استخدم المفتاح مكان YOUR_KEY في Bearer YOUR_KEY.
  3. ضبط Header Auth في عقدة HTTP Request اضبط Authentication على Generic Credential Type واستخدم Header Auth. اجعل الاسم Authorization والقيمة Bearer YOUR_KEY؛ وتخزّن بيانات الاعتماد المفتاح.
    بيانات اعتماد Header Auth
    Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

سحب البيانات دون كتابة شيفرة

عنوان URL الأساسي هو https://api.narwhalapi.com، وتتضمن كل عيّنة العنوان الكامل الذي تدخله في العقدة. استخدم عقدة HTTP Request منفصلة لكل مجال تربطه، مع عنوانه المطابق ومعالجة استجابته. وتبقى إعدادات Header Auth نفسها في هذه العقد كلها.

  1. إضافة عقدة HTTP Request اضبط الطريقة على GET وأدخل عنوان URL للمجال الذي تريد سحبه. استخدم بيانات اعتماد Header Auth في الطلب؛ وتستخدم عيّنات المجالات أدناه إعداد المصادقة نفسه.
  2. إضافة معلمات الاستعلام ضع معلمات الاستعلام في قائمة معلمات الاستعلام بالعقدة؛ وفي مواعيد الإصدار استخدم عنوان التقويم مع countries وstart_date وend_date وlimit لتقويم إصدارات نوفمبر 2026. أدخل USA في countries و2026-11-01 في start_date و2026-11-30 في end_date و100 في limit.
  3. تقسيم قائمة الاستجابة أضف عقدة Split Out بعد HTTP Request عندما تحتوي الاستجابة على قائمة. اضبط حقلها على holidays أو releases أو observations أو rates أو meetings بحسب الطلب لتحصل على عنصر لكل صف.
  4. ربط الوجهة اربط العناصر الناتجة بعقدة وجهة مثل جدول أو بريد إلكتروني بحسب إعدادك. اقرأ الحقول الظاهرة في العيّنة المطابقة؛ وفي حالة Brent اقرأ {{ $json.price }} من كائن الاستجابة الوحيد.

شغّله وفق جدول

أضف عقدة Schedule Trigger لبدء سير العمل على فترات زمنية، مثل كل يوم عند 07:00. ضعها قبل HTTP Request حتى يبدأ المشغّل طلب البيانات. وفي الاستجابة التي تعيد قائمة يكون التسلسل: Schedule Trigger ثم HTTP Request ثم Split Out ثم عقدة الوجهة.

استخدم حقل Split Out المطابق للمجال الذي تطلبه. استجابة Brent كائن واحد، لذا مرّر حقل price الخاص بها إلى الوجهة. وللمزيد عن الطلبات المجدولة راجع جدولة سحب يومي للبيانات.

الإجازات الرسمية في n8n

اطلب الإجازات الرسمية في الولايات المتحدة لعام 2026، ثم قسّم القائمة holidays. لكل إجازة date وname؛ اقرأ هذين الحقلين من كل عنصر عند ربط الوجهة. يتضمن عنوان URL الدولة والسنة معًا، بينما تستخدم عقدة Split Out حقل القائمة الذي يعيده الطلب. وإذا كانت الوجهة جدولًا فاستخدم {{ $json.date }} لتاريخ الإجازة و{{ $json.name }} لاسمها.

طلب الإجازات الرسمية وحقوله
Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

Holidays   GET https://api.narwhalapi.com/v1/calendars/holidays/USA/2026
           Split Out field: holidays            read: {{ $json.date }}, {{ $json.name }}

مواعيد الإصدار في n8n

اسحب مواعيد الإصدار الاقتصادية في الولايات المتحدة لشهر نوفمبر 2026 بطلب التقويم ومعلمات استعلامه. قسّم القائمة releases لقراءة عنصر لكل إصدار. تتضمن حقول الاستجابة at وperiod وtopic وstatus؛ وتقرأ العيّنة at وtopic للوجهة. بعد Split Out استخدم {{ $json.at }} لوقت الإصدار و{{ $json.topic }} للموضوع.

طلب مواعيد الإصدار وحقوله
Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

Releases   GET https://api.narwhalapi.com/v1/economics/calendar
           query: countries=USA, start_date=2026-11-01, end_date=2026-11-30, limit=100
           Split Out field: releases            read: {{ $json.at }}, {{ $json.topic }}

البيانات الاقتصادية في n8n

تتضمن البيانات الاقتصادية في Narwhal مؤشر CPI والتضخم والناتج المحلي الإجمالي (GDP) والعوائد. استخدم طلب ملاحظات CPI للبيانات الاقتصادية الأمريكية مع start=2025-09 في قائمة معلمات الاستعلام. قسّم observations للحصول على عنصر لكل ملاحظة، ثم اقرأ period وvalue. احتفظ بالفترة مع القيمة في الوجهة حتى تحتفظ كل ملاحظة بمرجعها الزمني.

طلب CPI وحقوله
Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

Economics  GET https://api.narwhalapi.com/v1/economics/USA/cpi/observations
           query: start=2025-09
           Split Out field: observations  read: {{ $json.period }}, {{ $json.value }}

السلع في n8n

اطلب سعر Brent الفوري بالدولار الأمريكي (USD) عبر عنوان URL الخاص بالسلع. الاستجابة هنا كائن واحد، لذا اقرأ price مباشرةً بالتعبير الموضح في العيّنة. تشمل رموز الأسعار الفورية على سبيل المثال XAU وXAG وXPT وXPD وXCU وBRENT وWTI. يستخدم الطلب هنا BRENT وUSD في عنوان URL.

طلب Brent وحقله
Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

Commodity  GET https://api.narwhalapi.com/v1/commodities/spot/BRENT/USD
           read: {{ $json.price }}

أسعار الصرف في n8n

اسحب أسعار الصرف مع USD في عنوان URL وcurrencies=EUR,IDR في قائمة معلمات الاستعلام. قسّم القائمة rates المُعادة، ثم اقرأ currency وrate من كل عنصر. أرسل الحقلين معًا إلى الوجهة إذا أردت ظهور العملة بجانب سعرها في كل صف. العملتان المطلوبتان هما EUR وIDR، والعملة الأساسية هي USD.

طلب FX وحقوله
Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

FX         GET https://api.narwhalapi.com/v1/fx/rates/USD
           query: currencies=EUR,IDR
           Split Out field: rates  read: {{ $json.currency }}, {{ $json.rate }}

التوقعات في n8n

اسحب توقعات مسار سياسة الاحتياطي الفيدرالي، ثم قسّم القائمة meetings إلى عناصر منفصلة. لكل اجتماع resolves_at وp_cut وp_hold وp_hike. تقرأ العيّنة resolves_at وp_hold؛ فاستخدم هذين التعبيرين لتمرير وقت حسم الاجتماع واحتمال الإبقاء على الفائدة إلى الوجهة. واقرأ p_cut لاحتمال الخفض وp_hike لاحتمال الرفع إذا أردت هذين الحقلين في الوجهة.

طلب التوقعات وحقوله
Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

Predictions GET https://api.narwhalapi.com/v1/predictions/policy-paths/federal-reserve
           Split Out field: meetings  read: {{ $json.resolves_at }}, {{ $json.p_hold }}

هل يمكنني وضع مفتاح API في عنوان URL؟

احتفظ بالمفتاح في بيانات اعتماد Header Auth. عنوان URL الخاص بالطلب مخصص لنقطة النهاية، وتضيف بيانات الاعتماد Authorization: Bearer YOUR_KEY ترويسةً. وتوضع معلمات الاستعلام في قائمة معلمات الاستعلام بالعقدة لكل طلب.

كيف أتعامل مع الخطأ 429؟

فعّل Retry On Fail في عقدة HTTP Request والتزم بقيمة Retry-After. وللمزيد عن هذه الاستجابة والتخزين المؤقت راجع تخزين الاستجابات مؤقتًا والتعامل مع أخطاء 429.

نُشر في .

الخطوات التالية