استخدم Narwhal API في Zapier

يمكنك استخدام Zapier وNarwhal لجلب الإجازات الرسمية وتواريخ الإصدار والبيانات الاقتصادية والسلع وأسعار الصرف واحتمالات أسواق التنبؤ إلى البريد الإلكتروني أو Slack أو صفوف الجداول. اربط Schedule by Zapier بطلب GET في Webhooks by Zapier، ثم استخدم الحقول المعادة في الإجراءات اللاحقة.

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

يربط Zapier مشغّلًا مجدولًا بإجراءات تطلب البيانات وتستخدم الاستجابة. ستحصل في النهاية على Zap يستدعي Narwhal ويمرر الحقول التي تحتاج إليها إلى بريد إلكتروني أو إجراء Slack أو صف في جدول. يستخدم Narwhal حسابًا واحدًا ومفتاح API واحدًا عبر واجهات البيانات التابعة له؛ ويشترك REST وMCP في المفتاح نفسه. Webhooks by Zapier تطبيق مميز (Premium) في Zapier، لذا تأكد من أن خطة Zapier لديك تتضمن Webhooks by Zapier قبل إعداد الطلب.

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

  1. أنشئ مفتاحًا مجانيًا احصل على مفتاح مجاني من narwhalapi.com/signup. استخدم هذا المفتاح لطلبات Narwhal في Zap، أيًّا كان مجال البيانات الذي تختاره.
  2. تخزين المفتاح احتفظ بالمفتاح في متغير بيئة اسمه NARWHAL_API_KEY. يحتاج رأس الطلب إلى قيمة المفتاح مسبوقة بكلمة Bearer.
  3. أضف رأس الطلب في Webhooks by Zapier، استخدم Custom Request بالطريقة GET وأضف الرأس Authorization: Bearer YOUR_KEY. استبدل YOUR_KEY بمفتاح Narwhal الخاص بك؛ وتستخدم العناوين القاعدة https://api.narwhalapi.com.

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

  1. أضف المشغّل المجدول استخدم Schedule by Zapier مشغّلًا. اضبطه على التشغيل كل يوم أو كل ساعة بحسب عدد مرات إرسال البيانات إلى الإجراءات اللاحقة.
  2. أضف طلب البيانات أضف Webhooks by Zapier واستخدم Custom Request بالطريقة GET. أدخل عنوان URL للمجال الذي تريده ورأس Authorization؛ وتقرن إعدادات الطلب هنا كل عنوان URL بحقل الاستجابة المطلوب استخدامه.
  3. استخدم الحقول المعادة أضف إجراء بريد إلكتروني أو Slack أو صف جدول، وطابق الحقول المعادة بالاسم. فمثلًا، تحتوي استجابة السلع على price بينما تحتوي استجابة الإجازات الرسمية على holidays.
  4. تعامل مع قوائم الصفوف عندما تصل الصفوف في حقل قائمة، أضف خطوة Looping أو Formatter لمعالجة صف واحد في كل مرة. استخدم حقول ذلك الصف في الإجراء الذي يحتاج إليها، مثل تاريخ الإجازة واسمها في صف جدول.
Webhooks by Zapier، وCustom Request لكل مجال
Header: Authorization: Bearer YOUR_KEY

Holidays    GET https://api.narwhalapi.com/v1/calendars/holidays/USA/2026
            (field: holidays)
Releases    GET https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-11-01&end_date=2026-11-30&limit=100
            (field: releases)
Economics   GET https://api.narwhalapi.com/v1/economics/USA/cpi/observations?start=2025-09
            (field: observations)
Commodity   GET https://api.narwhalapi.com/v1/commodities/spot/BRENT/USD  (field: price)
FX          GET https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,IDR
            (field: rates)
Predictions GET https://api.narwhalapi.com/v1/predictions/policy-paths/federal-reserve
            (field: meetings)

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

يمكن لـ Schedule by Zapier تشغيل الطلب كل يوم أو كل ساعة. يحدد المشغّل متى يطلب Zap البيانات من Narwhal، وتستخدم الإجراءات التالية الحقول التي يعيدها ذلك الطلب. اضبط الجدول الزمني بحسب البيانات التي تريد تمريرها إلى البريد الإلكتروني أو Slack أو صف جدول.

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

يعيد طلب الإجازات الرسمية holidays للولايات المتحدة لعام 2026. لكل إجازة date وname يمكنك استخدامهما معًا في إجراء لاحق. ولوضع إجازات منفردة في صفوف جدول، عالج قائمة holidays صفًا صفًا بخطوة Looping أو Formatter قبل مطابقة تلك الحقول.

إعدادات Custom Request
Method: GET
URL: https://api.narwhalapi.com/v1/calendars/holidays/USA/2026
Header: Authorization: Bearer YOUR_KEY
Read field: holidays

تواريخ الإصدار في Zapier

يعيد طلب التقويم الاقتصادي releases للولايات المتحدة خلال نوفمبر 2026. لكل إصدار at وperiod وtopic وstatus. استخدم هذه الحقول عندما يحتاج الإجراء إلى تاريخ الإصدار وسياقه، وعالج قائمة releases صفًا صفًا إذا أردت إجراءً منفصلًا لكل إصدار. يوفر التقويم تواريخ الإصدار، بينما يستخدم طلب البيانات الاقتصادية ملاحظات لها فترات وقيم. اختر عنوان التقويم عندما تكون الحقول التي يحتاج إليها إجراؤك هي وقت الإصدار أو الموضوع أو الحالة.

إعدادات Custom Request
Method: GET
URL: https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-11-01&end_date=2026-11-30&limit=100
Header: Authorization: Bearer YOUR_KEY
Read field: releases

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

يطلب طلب CPI ملاحظات الولايات المتحدة بدءًا من سبتمبر 2025 ويعيد observations. لكل ملاحظة period وvalue. طابق الحقلين معًا في الإجراء عندما تحتاج إلى القيمة بجانب الفترة التي تصفها؛ واستخدم خطوة Looping أو Formatter لمعالجة الملاحظات صفًا صفًا. تشمل البيانات الاقتصادية في Narwhal مؤشر CPI والتضخم والناتج المحلي الإجمالي والعوائد؛ ويستخدم هذا الطلب CPI.

إعدادات Custom Request
Method: GET
URL: https://api.narwhalapi.com/v1/economics/USA/cpi/observations?start=2025-09
Header: Authorization: Bearer YOUR_KEY
Read field: observations

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

السلع في Zapier

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

إعدادات Custom Request
Method: GET
URL: https://api.narwhalapi.com/v1/commodities/spot/BRENT/USD
Header: Authorization: Bearer YOUR_KEY
Read field: price

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

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

إعدادات Custom Request
Method: GET
URL: https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,IDR
Header: Authorization: Bearer YOUR_KEY
Read field: rates

التنبؤات في Zapier

يعيد طلب مسار سياسة الاحتياطي الفيدرالي (Federal Reserve) meetings. لكل اجتماع resolves_at وp_cut وp_hold وp_hike. استخدم وقت حسم الاجتماع مع احتمالات الخفض والتثبيت والرفع في إجراء لاحق؛ وعالج قائمة meetings صفًا صفًا عندما تريد استخدام كل اجتماع على حدة.

إعدادات Custom Request
Method: GET
URL: https://api.narwhalapi.com/v1/predictions/policy-paths/federal-reserve
Header: Authorization: Bearer YOUR_KEY
Read field: meetings

هل يستطيع Zapier استقبال Webhooks من Narwhal؟

نعم. يمكن أن يكون عنوان Catch Hook من Zapier وجهة webhook في Narwhal. Webhooks متاحة لكل حساب، وتكلّف كل عملية تسليم استدعاءً واحدًا. يطلب Zap من نوع GET مجدول البيانات من Narwhal؛ أما Catch Hook فيستقبل webhook مرسلًا إلى عنوانه.

لماذا يستخدم Zap هذا العدد الكبير من الطلبات؟

يكلّف كل طلب GET ناجح استدعاءً واحدًا، لذا فإن Zap كل ساعة يستدعي ستة عناوين URL ينفّذ 144 استدعاءً في اليوم و4,320 في الشهر، أي نحو $8.64 بسعر $2 لكل 1,000. احسب عناوين URL التي يستدعيها Zap إلى جانب عدد مرات تشغيل المشغّل. وZap الذي يطلب عدة مجالات بيانات ينفّذ طلبًا لكل عنوان URL، حتى لو استخدمت الإجراءات اللاحقة الحقول معًا في البريد الإلكتروني أو صف الجدول نفسه.

نُشر في .

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