يمكنك استخدام Make مع Narwhal API لسحب الإجازات الرسمية ومواعيد الإصدار والبيانات الاقتصادية وأسعار السلع الفورية وأسعار الصرف واحتمالات أسواق التنبؤ إلى سيناريو. اضبط طلب HTTP بمفتاح API، ثم اربط حقول الاستجابة المُحلَّلة بالوحدات اللاحقة.
ما الذي ستعدّه
يستخدم Make وحدة HTTP لطلب البيانات من Narwhal API وتمرير الحقول المُحلَّلة إلى الوحدات اللاحقة. ستحصل على سيناريو يضم طلب GET وترويسة Authorization وتحليل الاستجابة، مع جدولة تشغيل على الوحدة الأولى. يستخدم Narwhal حسابًا واحدًا ومفتاح API واحدًا لجميع واجهات البيانات، ويتشارك REST وMCP المفتاح نفسه. عنوان URL الأساسي للطلبات هو https://api.narwhalapi.com. تتضمن واجهة البيانات الاقتصادية مؤشر CPI والتضخم والناتج المحلي الإجمالي (GDP) والعوائد. يوفّر التقويم الاقتصادي مواعيد الإصدار، ويوفّر طلب ملاحظات CPI أدناه الفترات والقيم.
اضبط مفتاح API الخاص بك
- أنشئ مفتاحًا مجانيًا احصل على مفتاح API مجاني من narwhalapi.com/signup. استخدم هذا المفتاح لطلبات Narwhal التي تضيفها إلى سيناريو Make، بما فيها الطلبات الخاصة بمجالات البيانات المختلفة.
- حفظ المفتاح في متغير بيئة احتفظ بمفتاحك في متغير بيئة اسمه
NARWHAL_API_KEY. تستخدم إعدادات الطلبYOUR_KEYكعنصر نائب؛ استبدله بمفتاحك عند إدخال ترويسة Authorization في Make. - ضبط ترويسة الطلب استخدم
Authorizationاسمًا للترويسة وBearer YOUR_KEYقيمةً لها. أبقِ البادئةBearerعند استبدال العنصر النائب، واستخدم الترويسة نفسها في كل طلبات GET أدناه.
سحب البيانات دون كتابة شيفرة
- إضافة وحدة HTTP أضف وحدة HTTP إلى السيناريو واختر Make a request. اضبط الطريقة على GET وأدخل عنوان URL للمجال الذي تريد سحبه. في مثال Brent يكون العنوان
https://api.narwhalapi.com/v1/commodities/spot/BRENT/USD، ويستخدم الترويسة وإعدادات التحليل نفسها المستخدمة في طلبات القوائم. - إدخال إعدادات الطلب أضف ترويسة Authorization بمفتاحك واضبط Parse response على Yes. وفي الطلبات التي تتضمن معلمات استعلام، استخدم القيم الواردة في الإعدادات أدناه، مثل الدولة ونطاق التواريخ في مواعيد الإصدار.
- ربط حقول الاستجابة اربط الحقول المُحلَّلة بالوحدات اللاحقة. استخدم Iterator على حقل القائمة في حالات الإجازات ومواعيد الإصدار والملاحظات والأسعار والاجتماعات؛ أما Brent فاربط الحقل
data.priceمباشرةً.
هذه إعدادات وحدة HTTP لكل مجال. تتضمن طلبات مواعيد الإصدار والبيانات الاقتصادية وأسعار الصرف قيم سلسلة استعلام إلى جانب نقطة النهاية. أبقِ هذه القيم مع طلبها عند إدخال عنوان URL وإعدادات الاستعلام في Make.
Headers: Authorization = Bearer YOUR_KEY Parse response: Yes
Holidays GET https://api.narwhalapi.com/v1/calendars/holidays/USA/2026
Iterator on: data.holidays fields: date, name
Releases GET https://api.narwhalapi.com/v1/economics/calendar
Query string: countries=USA, start_date=2026-11-01,
end_date=2026-11-30, limit=100
Iterator on: data.releases fields: at, topic, status
Economics GET https://api.narwhalapi.com/v1/economics/USA/cpi/observations
Query string: start=2025-09
Iterator on: data.observations fields: period, value
Commodity GET https://api.narwhalapi.com/v1/commodities/spot/BRENT/USD
map: data.price
FX GET https://api.narwhalapi.com/v1/fx/rates/USD
Query string: currencies=EUR,IDR
Iterator on: data.rates fields: currency, rate
Predictions GET https://api.narwhalapi.com/v1/predictions/policy-paths/federal-reserve
Iterator on: data.meetings fields: resolves_at, p_holdشغّله وفق جدول
افتح جدولة السيناريو من أيقونة الساعة في الوحدة الأولى. يمكنك ضبط تشغيل السيناريو كل N دقيقة أو في أوقات محددة. تنتمي الجدولة إلى الوحدة الأولى في السيناريو، بينما تحتوي وحدة HTTP على طريقة GET وعنوان URL والترويسة وإعداد Parse response. وللسحب اليومي استخدم خيار الجدولة في أوقات محددة؛ وستجد سير العمل المرتبط في جدولة سحب يومي للبيانات.
الإجازات الرسمية في Make
اطلب الإجازات الرسمية في الولايات المتحدة لعام 2026 واستخدم القائمة holidays. لكل إجازة date وname، ويمكن ربط الحقلين بالوحدات اللاحقة. السنة والدولة جزءان من عنوان URL لهذا الطلب. ضع Iterator على data.holidays واختر حقول الإجازة من مخرجاته عند إعداد الوحدات التالية. وعند ربط اسم الإجازة، استخدم معه التاريخ من عنصر الإجازة نفسه.
Headers: Authorization = Bearer YOUR_KEY Parse response: Yes
Holidays GET https://api.narwhalapi.com/v1/calendars/holidays/USA/2026
Iterator on: data.holidays fields: date, nameمواعيد الإصدار في Make
استخدم التقويم الاقتصادي لمواعيد الإصدار في الولايات المتحدة اعتبارًا من نوفمبر 2026. يضبط الطلب start_date على 2026-11-01 وend_date على 2026-11-30 وlimit على 100. لكل إصدار الحقول at وperiod وtopic وstatus. تربط العيّنة وقت الإصدار والموضوع والحالة من data.releases، كما أن الفترة متاحة في كل إصدار إذا احتاجتها وحدة لاحقة.
Headers: Authorization = Bearer YOUR_KEY Parse response: Yes
Releases GET https://api.narwhalapi.com/v1/economics/calendar
Query string: countries=USA, start_date=2026-11-01,
end_date=2026-11-30, limit=100
Iterator on: data.releases fields: at, topic, statusالبيانات الاقتصادية في Make
اطلب ملاحظات CPI للولايات المتحدة مع start=2025-09 في سلسلة الاستعلام. تتضمن الاستجابة القائمة observations ولكل ملاحظة period وvalue. اربط الحقلين من مخرجات Iterator عندما تحتاج وحدة لاحقة إلى قيمة CPI مع فترتها. استخدم data.observations حقل القائمة في Iterator لهذا الطلب.
Headers: Authorization = Bearer YOUR_KEY Parse response: Yes
Economics GET https://api.narwhalapi.com/v1/economics/USA/cpi/observations
Query string: start=2025-09
Iterator on: data.observations fields: period, valueالأسعار الفورية للسلع في Make
اسحب سعر Brent الفوري بالدولار الأمريكي (USD) عبر طلب السلع. تحتوي استجابته على حقل price واحد يمكنك ربطه بوحدة لاحقة باسم data.price. يستخدم هذا الطلب BRENT رمزًا للسعر الفوري وUSD في عنوان URL. تشمل رموز الأسعار الفورية على سبيل المثال XAU وXAG وXPT وXPD وXCU وBRENT وWTI.
Headers: Authorization = Bearer YOUR_KEY Parse response: Yes
Commodity GET https://api.narwhalapi.com/v1/commodities/spot/BRENT/USD
map: data.priceأسعار الصرف في Make
اطلب أسعار صرف EUR وIDR مقابل USD بوضع USD في نقطة النهاية وcurrencies=EUR,IDR في سلسلة الاستعلام. تحتوي القائمة rates في الاستجابة على الحقلين currency وrate. احتفظ بحقل العملة مع سعرها عند ربط مخرجات Iterator بوحدة لاحقة، حتى تحتفظ القيمة المربوطة بالعملة التي أُعيدت معها. في العيّنة يُطلب EUR وIDR معًا، ويستخدم Iterator القائمة data.rates التي يعيدها الطلب.
Headers: Authorization = Bearer YOUR_KEY Parse response: Yes
FX GET https://api.narwhalapi.com/v1/fx/rates/USD
Query string: currencies=EUR,IDR
Iterator on: data.rates fields: currency, rateاحتمالات أسواق التنبؤ في Make
استخدم طلب مسار سياسة الاحتياطي الفيدرالي لسحب القائمة meetings. لكل اجتماع الحقول resolves_at وp_cut وp_hold وp_hike. تختار العيّنة resolves_at وp_hold من مخرجات Iterator. ويمكنك أيضًا ربط p_cut وp_hike من الاجتماع نفسه عندما تحتاجهما وحدة لاحقة إلى جانب احتمال الإبقاء على الفائدة.
Headers: Authorization = Bearer YOUR_KEY Parse response: Yes
Predictions GET https://api.narwhalapi.com/v1/predictions/policy-paths/federal-reserve
Iterator on: data.meetings fields: resolves_at, p_holdكيف أقرأ القائمة؟
عند تفعيل Parse response تظهر القائمة تحت data. يحوّل Iterator تلك القائمة إلى عنصر لكل صف. اضبط Iterator على حقل القائمة نفسه، مثل data.releases، ثم اربط حقول كل عنصر بالوحدات اللاحقة.
كم عملية يستهلكها كل تشغيل؟
يستهلك Make عملية واحدة عن كل تشغيل لوحدة، وتُحدَّد الحصص من جانب Make. عند تقدير العمليات التي تستهلكها جدولة السيناريو، احسب عدد مرات تشغيل الوحدات.
نُشر في .