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

البيانات التاريخية لـالتضخم الموحد API

استرجع سجل التضخم الموحد (HICP) الشهري لبلد واحد، من الأقدم إلى الأحدث.

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

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

نقطة نهاية REST
GET /v1/economics/{country}/harmonised-inflation/observations
طلب نموذجي
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/FRA/harmonised-inflation/observations?start=2026-01&limit=2" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

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

المعلمات

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

الاسممطلوبالنوعالمعنى
countryنعمالمسار · ISO alpha-3رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
startلاالاستعلام · YYYY-MMأول فترة رصد، وهي مشمولة في النتائج.
endلاالاستعلام · YYYY-MMآخر فترة رصد، وهي مشمولة في النتائج.
limitلاالاستعلام · عدد صحيح, 1–1000الحد الأقصى لعدد الفترات المُعادة. القيمة الافتراضية 100. قد تحتوي الصفحة على فترات أقل؛ اتبع next_cursor.
cursorلاالاستعلام · سلسلة نصية غير قابلة للتفسيرقيمة next_cursor من الصفحة السابقة.
series_idلاالاستعلام · UUIDاختياري. احذفه للحصول على المعدل السنوي، وهو السلسلة الافتراضية. مرر `series_id` لمستوى المؤشر لقراءة المؤشر بدلًا منه. ابحث عنه عبر `GET /v1/economics/{country}/series?family=harmonised-inflation`: إنه السلسلة التي تكون قيمة `unit` فيها `index`.

الاستجابة

استجابة نموذجية
{
  "source": {
    "publisher": "Eurostat",
    "distributor": "Eurostat"
  },
  "measure": "year_over_year",
  "seasonal_adjustment": "not_seasonally_adjusted",
  "classification": "COICOP 2018, all items (HICP total)",
  "country": "FRA",
  "series_id": "1b1f2448-2ba6-4523-a6ce-55c488ca15d1",
  "unit": "percent",
  "observations": [
    {
      "period": "2026-01",
      "value": "0.4"
    },
    {
      "period": "2026-02",
      "value": "1.1"
    }
  ],
  "next_cursor": "eyJhZnRlciI6IjIwMjYtMDIi…"
}

يطلب مثال السجل limit=2، فيحمل صفين. اختُصر next_cursor هنا. أما الحقيقي فهو نص معتم أطول.

حقلالنوعمطلوبالمعنى
sourceكائننعممن نشر الرقم. publisher هو الهيئة الإحصائية صاحبة الرقم، وdistributor هو الهيئة التي تقرأ Narwhal منها. مصدر واحد لكل سلسلة، طوال سجلها. لا يوجد released_on.
measureسلسلة نصيةنعمyear_over_year هو معدل التغير السنوي بالنسبة المئوية. وlevel هو مستوى المؤشر.
seasonal_adjustmentسلسلة نصيةنعمAlways not_seasonally_adjusted.
classificationسلسلة نصيةنعممجمّع الأسعار الذي يغطيه الرقم: جميع البنود، COICOP 2018.
base_periodسلسلة نصيةلاالسنة التي يساوي فيها المؤشر 100. Present for the index level only.
base_valueسلسلة نصية لعدد عشريلاقيمة المؤشر في سنة الأساس. تظهر لمستوى المؤشر فقط.
countryسلسلة نصيةنعمرمز الدولة المطلوب بالأحرف الكبيرة وفق ISO alpha-3.
series_idسلسلة نصيةنعمالسلسلة التي يأتي منها الرقم. مررها بوصفها series_id لقراءة السلسلة نفسها مرة أخرى.
unitسلسلة نصيةنعمpercent للمعدل السنوي، وindex لمستوى المؤشر.
observationsمصفوفةنعمقراءات من الأقدم إلى الأحدث، واحدة لكل فترة. قد تحمل الصفحة قراءات أقل من limit. تابع next_cursor حتى يصبح null.
observations[].periodسلسلة نصيةنعمالشهر أو الربع أو السنة الرسمية التي تمثلها القراءة.
observations[].valueسلسلة نصية لعدد عشرينعمالرقم في unit: المعدل السنوي بالنسبة المئوية، وقد يكون سالبًا، أو مستوى المؤشر.
observations[].statusسلسلة نصيةلايظهر فقط للرقم الذي يضع الناشر عليه علامة: estimated أو break_in_series أو definition_differs أو break_in_series_and_definition_differs. يُحذف في غير ذلك.
observations[].release_statusسلسلة نصيةلاpreliminary عندما يصنّف الناشر الرقم على أنه مؤقت. يُحذف في غير ذلك.
next_cursorسلسلة نصية أو nullنعممرر هذا كما هو بوصفه cursor لقراءة الصفحة التالية. وهو null في الصفحة الأخيرة.

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

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

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

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

يعيد هذا المسار سلسلة Narwhal المخزنة الحالية، من الأقدم إلى الأحدث. وبدون start يبدأ من أقدم فترة مخزنة، لذا مرر start لقراءة الفترات الحديثة. ولا يقبل as_of ولا version، فلا يمكن قراءة نسخة أقدم. وتحذف Narwhal القراءات المفقودة بدلًا من ملئها.

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

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

10 الدول

DNK, ESP, FIN, FRA, IRL, LVA, NLD, PRT, SVN, SWE

المؤشر الموحد الشهري لأسعار المستهلك (HICP)، لجميع البنود، من Eurostat، غير معدّل موسميًا. وهو ليس مسار inflation الوطني، ويختلف الرقمان لبلد واحد. السلسلة الافتراضية هي معدل التغير السنوي بالنسبة المئوية، وقد يكون سالبًا. ولمستوى المؤشر أساس 2025=100. الفترة شهر بصيغة YYYY-MM. أي بلد آخر يُرجع 404 series_not_found ولا يُحاسَب عليه. لقراءة مستوى المؤشر، اعرض سلاسل البلد أولًا: يُرجع GET /v1/economics/{country}/series?family=harmonised-inflation كل سلسلة مع series_id وname وunit (percent أو index) وis_default، ويتيح طلب يتضمن limit وcursor التنقل بين الصفحات. مرّر series_id الذي تكون قيمة unit فيه index إلى مسار الأحدث أو التاريخ.

List the سلسلة

طلب نموذجي
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/FRA/series?family=harmonised-inflation" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية
{
  "series": [
    {
      "country": "FRA",
      "series_id": "11bc022a-cd6e-4847-8ff8-11dae4e93451",
      "unit": "index",
      "name": "Harmonised index of consumer prices",
      "frequency": "monthly",
      "first_period": "2000-01",
      "last_period": "2026-10",
      "family": "harmonised-inflation",
      "definition": {
        "base_period": "2025",
        "base_value": "100",
        "seasonal_adjustment": "not_seasonally_adjusted",
        "measure": "level",
        "classification": "COICOP 2018, all items (HICP total)"
      }
    },
    {
      "country": "FRA",
      "series_id": "1b1f2448-2ba6-4523-a6ce-55c488ca15d1",
      "unit": "percent",
      "name": "Harmonised inflation, annual rate",
      "is_default": true,
      "frequency": "monthly",
      "first_period": "2000-01",
      "last_period": "2026-10",
      "family": "harmonised-inflation",
      "definition": {
        "measure": "year_over_year",
        "seasonal_adjustment": "not_seasonally_adjusted",
        "annualization": "not_annualized",
        "classification": "COICOP 2018, all items (HICP total)"
      }
    }
  ],
  "next_cursor": null
}

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

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

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