تصفّح التوثيق كاملًا

الإنتاج الصناعي API

استرجع أحدث مؤشر شهري للإنتاج الصناعي لبلد واحد، مع أساسه ومصدره.

economics_get_industrial_production متاح عبر REST وعبر الأداة economics_get_industrial_production أداة MCP. كلتاهما تُرجع بنية البيانات نفسها وتستخدم الرصيد نفسه.

نقطة النهاية والطلب

نقطة نهاية REST
GET /v1/economics/{country}/industrial-production
طلب نموذجي
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/industrial-production" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

يستخدم MCP أداة economics_get_industrial_production مع الوسيطات المقابلة أدناه.

المعلمات

تنسيق الفترة المقبول لهذه العملية هو YYYY-MM.

الاسممطلوبالنوعالمعنى
countryنعمالمسار · ISO alpha-3رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
periodلاالاستعلام · YYYY-MMلا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها.
series_idلاالاستعلام · UUIDاختياري. `series_id` لسلسلة واحدة، مأخوذ من إجابة سابقة. احذفه لقراءة السلسلة الافتراضية للبلد.

الاستجابة

استجابة نموذجية
{
  "source": {
    "publisher": "OECD",
    "distributor": "OECD"
  },
  "seasonal_adjustment": "seasonally_and_calendar_adjusted",
  "base_period": "2015",
  "base_value": "100",
  "period": "2026-09",
  "value": "102.9",
  "country": "USA",
  "series_id": "ea690cc4-a528-4c6d-b07a-5ecbdac08575",
  "unit": "index"
}
حقلالنوعمطلوبالمعنى
sourceكائننعممن نشر الرقم. publisher هو الهيئة الإحصائية صاحبة الرقم، وdistributor هو الهيئة التي تقرأ Narwhal منها. مصدر واحد لكل سلسلة، طوال سجلها. لا يوجد released_on.
seasonal_adjustmentسلسلة نصيةنعمAlways seasonally_and_calendar_adjusted.
base_periodسلسلة نصيةنعمالسنة التي يساوي فيها المؤشر 100: 2021 لسلاسل Eurostat، و2015 لسلاسل OECD.
base_valueسلسلة نصية لعدد عشرينعمقيمة المؤشر في سنة الأساس. 100 لكل سلسلة هنا.
periodسلسلة نصيةنعمفترة الرصد الرسمية المعادة.
valueسلسلة نصية لعدد عشرينعممستوى المؤشر، وأساسه في base_period وbase_value. وهو مستوى وليس معدل نمو.
statusسلسلة نصيةلايظهر فقط للرقم الذي يضع الناشر عليه علامة: estimated أو break_in_series أو definition_differs أو break_in_series_and_definition_differs. يُحذف في غير ذلك.
release_statusسلسلة نصيةلاpreliminary عندما يصنّف الناشر الرقم على أنه مؤقت. يُحذف في غير ذلك.
countryسلسلة نصيةنعمرمز الدولة المطلوب بالأحرف الكبيرة وفق ISO alpha-3.
series_idسلسلة نصيةنعمالسلسلة التي يأتي منها الرقم. مررها بوصفها series_id لقراءة السلسلة نفسها مرة أخرى.
unitسلسلة نصيةنعمAlways index.

أخطاء API والرصيد

  • 400 invalid_query: A query parameter is unknown or repeated, country is not three uppercase letters, series_id is not a UUID, or period is not a month in YYYY-MM format. version_id, version and as_of are not accepted on this route.
  • 401 invalid_api_key: مفتاح Bearer مفقود أو مرفوض.
  • 402 insufficient_credits: رصيدك لا يغطي الاستدعاء.
  • 404 series_not_found: البلد ليس في قائمة التغطية في هذه الصفحة، أو series_id ليس سلسلة لذلك البلد، أو لا توجد قراءة تطابق period. والبلد خارج القائمة يحصل على تفصيل يقول إن العائلة غير متاحة له. ولا يُحاسَب على 404.
  • 429 rate_limit_exceeded: بلغ حد النافذة القصيرة للشبكة أو الحساب. أعد المحاولة بعد Retry-After.
  • 503 economics_unavailable: لا تستطيع Narwhal تقديم السلسلة المخزنة بأمان.

Only a successful data response costs credit. راجع كل الأخطاء والترويسات وقواعد إعادة المحاولة.

حداثة البيانات

عند حذف period تُعاد أحدث قراءة مخزنة. يقرأ استدعاء API قاعدة بيانات Narwhal. ولا يستدعي الناشر مباشرةً. ولا تحتوي الإجابة على released_on، لأن التاريخ الذي يعرضه الموزّع ليس تاريخ إصدار الناشر.

اقرأ كيف تعمل فحوص المصدر والتحقق والإصدارات المخزنة والفحوص الفاشلة.

تغطية الإصدار التجريبي العام الحالي

15 الدول

BEL, BGR, BRA, CHL, CZE, EST, FIN, FRA, HRV, IRL, ITA, KOR, SVN, SWE, USA

مستوى المؤشر الشهري، معدّل تقويميًا وموسميًا. تستخدم سلاسل Eurostat 2021=100 وسلاسل OECD 2015=100، ويبيّن source وbase_period أيهما لبلد ما. تختلف الأسس بين البلدان، لذا قارن المستويات داخل بلد واحد فقط. الفترة شهر بصيغة YYYY-MM. أي بلد آخر يُرجع 404 not_found ولا يُحاسَب عليه.

يتوفر FX اليومي عبر واجهة API لأسعار الصرف.

العودة إلى جميع عمليات Economics.

هل كانت هذه الصفحة مفيدة؟