مرجع واجهة API للاقتصاد

أحدث الإصدارات والملاحظات التاريخية عبر عشر دول.

تعيد تسعة مسارات أحدث إصدار رسمي مقبول. وتسعة مسارات مطابقة /observations تعيد المسارات السلسلة الزمنية المقبولة الحالية. يستخدم REST وMCP المخططات نفسها ويستهلكان الحصة الشهرية نفسها.

عنوان URL الأساسي والمعلمات

مسار REST الأساسي

https://api.narwhalapi.com/v1/economics/{country}

country هو رمز ISO alpha-3 مدعوم بالأحرف الكبيرة.
period اختياري. احذفه للإصدار الأحدث أو مرر تنسيق الشهر أو الربع أو السنة للعملية.
يتطلب كل طلب ترويسة Bearer الموضحة في المصادقة.

اطلب فترة معروفة واحدة

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

الدول

AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP، و USA.

تدعم كل دولة العمليات التسع الأحدث والعمليات التاريخية التسع نفسها.

أحدث الإصدارات

افتح صفحة العملية للاطلاع على المعلمات الدقيقة وصيغ الفترات المقبولة وحقول الاستجابة والأمثلة والأخطاء والحداثة والحدود الحالية.

عملية	مسار REST	الفترة
مؤشر أسعار المستهلك	`/v1/economics/{country}/cpi`	`YYYY-MM`
التضخم	`/v1/economics/{country}/inflation`	`YYYY-MM`
البطالة	`/v1/economics/{country}/unemployment`	`YYYY, YYYY-MM, or YYYY-QN`
المشاركة في القوى العاملة	`/v1/economics/{country}/labour-force-participation`	`YYYY, YYYY-MM, or YYYY-QN`
الناتج المحلي الإجمالي	`/v1/economics/{country}/gdp`	`YYYY-QN`
نمو GDP	`/v1/economics/{country}/gdp-growth`	`YYYY-QN`
تجارة السلع	`/v1/economics/{country}/trade`	`YYYY or YYYY-MM`
صادرات السلع	`/v1/economics/{country}/trade/exports`	`YYYY or YYYY-MM`
واردات السلع	`/v1/economics/{country}/trade/imports`	`YYYY or YYYY-MM`

الملاحظات التاريخية

تقبل المسارات التاريخية start, end, limit، و cursorتأتي النتائج من الأقدم إلى الأحدث، وتصف السلسلة المقبولة الحالية، وليس كل إصدار منشور سابقًا.

عملية	مسار REST	الفترة
سجل مؤشر أسعار المستهلك	`/v1/economics/{country}/cpi/observations`	`YYYY-MM`
سجل التضخم	`/v1/economics/{country}/inflation/observations`	`YYYY-MM`
سجل البطالة التاريخي	`/v1/economics/{country}/unemployment/observations`	`YYYY, YYYY-MM, or YYYY-QN`
سجل المشاركة في القوى العاملة	`/v1/economics/{country}/labour-force-participation/observations`	`YYYY, YYYY-MM, or YYYY-QN`
سجل الناتج المحلي الإجمالي	`/v1/economics/{country}/gdp/observations`	`YYYY-QN`
سجل نمو GDP	`/v1/economics/{country}/gdp-growth/observations`	`YYYY-QN`
سجل تجارة السلع	`/v1/economics/{country}/trade/observations`	`YYYY-MM`
سجل صادرات السلع	`/v1/economics/{country}/trade/exports/observations`	`YYYY-MM`
سجل واردات السلع	`/v1/economics/{country}/trade/imports/observations`	`YYYY-MM`

اصطلاحات الحقول

حقل أو قاعدة	المعنى
`country`	رمز الدولة المطلوب وفق ISO alpha-3.
`period`	الشهر أو الربع أو السنة الرسمية الدقيقة التي تمثلها الاستجابة.
`released_on`	تاريخ النشر الرسمي، وليس وقت استرجاع Narwhal.
سلاسل عشرية	القيم الاقتصادية الرقمية عبارة عن سلاسل نصية للحفاظ على التمثيل العشري الدقيق.
الوحدات والأسس	تبقى الأسعار والعملات وأسس الأسعار والسنونة والتغطية وأسس المؤشرات واضحة حيثما ينطبق ذلك.
الإصدارات المفقودة	يغلق Narwhal المسار عند الفشل بدلًا من اختلاق القيم المفقودة أو ترحيلها أو تحويلها إلى أصفار.

OpenAPI والاكتشاف

حدود الإصدار التجريبي العام الحالي

يقتصر الاكتشاف العام على المسارات الثمانية عشر والدول العشر المذكورة أعلاه. ولا تندرج إندونيسيا والمسارات الإقليمية ضمن الإصدار التجريبي العام للبيانات الاقتصادية.

راجع الأخطاء والحصة لسلوك السلسلة المفقودة وعدم توفر الخدمة.