التضخم الموحد API
استرجع أحدث تضخم موحد (HICP) لبلد واحد: المعدل السنوي بالنسبة المئوية.
economics_ متاح عبر REST وعبر الأداة economics_ أداة MCP. كلتاهما تُرجع بنية البيانات نفسها وتستخدم الرصيد نفسه.
نقطة النهاية والطلب
GET /v1/economics/{country}/harmonised-inflationcurl --request GET \
--url "https://api.narwhalapi.com/v1/economics/FRA/harmonised-inflation" \
--header "Authorization: Bearer $NARWHAL_API_KEY"يستخدم MCP أداة economics_ مع الوسيطات المقابلة أدناه.
المعلمات
تنسيق الفترة المقبول لهذه العملية هو YYYY-MM.
| الاسم | مطلوب | النوع | المعنى |
|---|---|---|---|
country | نعم | المسار · ISO alpha-3 | رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية. |
period | لا | الاستعلام · YYYY-MM | لا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها. |
series_ | لا | الاستعلام · 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)",
"period": "2026-10",
"value": "3.7",
"country": "FRA",
"series_id": "1b1f2448-2ba6-4523-a6ce-55c488ca15d1",
"unit": "percent"
}| حقل | النوع | مطلوب | المعنى |
|---|---|---|---|
source | كائن | نعم | من نشر الرقم. publisher هو الهيئة الإحصائية صاحبة الرقم، وdistributor هو الهيئة التي تقرأ Narwhal منها. مصدر واحد لكل سلسلة، طوال سجلها. لا يوجد released_. |
measure | سلسلة نصية | نعم | year_ هو معدل التغير السنوي بالنسبة المئوية. وlevel هو مستوى المؤشر. |
seasonal_ | سلسلة نصية | نعم | Always not_. |
classification | سلسلة نصية | نعم | مجمّع الأسعار الذي يغطيه الرقم: جميع البنود، COICOP 2018. |
base_ | سلسلة نصية | لا | السنة التي يساوي فيها المؤشر 100. Present for the index level only. |
base_ | سلسلة نصية لعدد عشري | لا | قيمة المؤشر في سنة الأساس. تظهر لمستوى المؤشر فقط. |
period | سلسلة نصية | نعم | فترة الرصد الرسمية المعادة. |
value | سلسلة نصية لعدد عشري | نعم | الرقم في unit: المعدل السنوي بالنسبة المئوية، وقد يكون سالبًا، أو مستوى المؤشر. |
status | سلسلة نصية | لا | يظهر فقط للرقم الذي يضع الناشر عليه علامة: estimated أو break_ أو definition_ أو break_. يُحذف في غير ذلك. |
release_ | سلسلة نصية | لا | preliminary عندما يصنّف الناشر الرقم على أنه مؤقت. يُحذف في غير ذلك. |
country | سلسلة نصية | نعم | رمز الدولة المطلوب بالأحرف الكبيرة وفق ISO alpha-3. |
series_ | سلسلة نصية | نعم | السلسلة التي يأتي منها الرقم. مررها بوصفها series_ لقراءة السلسلة نفسها مرة أخرى. |
unit | سلسلة نصية | نعم | percent للمعدل السنوي، وindex لمستوى المؤشر. |
أخطاء API والرصيد
400 invalid_: A query parameter is unknown or repeated,query countryis not three uppercase letters,series_is not a UUID, orid periodis not a month inYYYY-MMformat.version_,id versionandas_are not accepted on this route.of 401 invalid_: مفتاح Bearer مفقود أو مرفوض.api_ key 402 insufficient_: رصيدك لا يغطي الاستدعاء.credits 404 series_: البلد ليس في قائمة التغطية في هذه الصفحة، أوnot_ found series_ليس سلسلة لذلك البلد، أو لا توجد قراءة تطابقid period. والبلد خارج القائمة يحصل على تفصيل يقول إن العائلة غير متاحة له. ولا يُحاسَب على 404.429 rate_: بلغ حد النافذة القصيرة للشبكة أو الحساب. أعد المحاولة بعدlimit_ exceeded Retry-After.503 economics_: لا تستطيع Narwhal تقديم السلسلة المخزنة بأمان.unavailable
Only a successful data response costs credit. راجع كل الأخطاء والترويسات وقواعد إعادة المحاولة.
حداثة البيانات
عند حذف period تُعاد أحدث قراءة مخزنة. يقرأ استدعاء API قاعدة بيانات Narwhal. ولا يستدعي الناشر مباشرةً. ولا تحتوي الإجابة على released_، لأن التاريخ الذي يعرضه الموزّع ليس تاريخ إصدار الناشر.
اقرأ كيف تعمل فحوص المصدر والتحقق والإصدارات المخزنة والفحوص الفاشلة.
تغطية الإصدار التجريبي العام الحالي
10 الدول
DNK, ESP, FIN, FRA, IRL, LVA, NLD, PRT, SVN, SWE
المؤشر الموحد الشهري لأسعار المستهلك (HICP)، لجميع البنود، من Eurostat، غير معدّل موسميًا. وهو ليس مسار inflation الوطني، ويختلف الرقمان لبلد واحد. السلسلة الافتراضية هي معدل التغير السنوي بالنسبة المئوية، وقد يكون سالبًا. ولمستوى المؤشر أساس 2025=100. الفترة شهر بصيغة YYYY-MM. أي بلد آخر يُرجع 404 series_ ولا يُحاسَب عليه. لقراءة مستوى المؤشر، اعرض سلاسل البلد أولًا: يُرجع GET / كل سلسلة مع series_ وname وunit (percent أو index) وis_، ويتيح طلب يتضمن limit وcursor التنقل بين الصفحات. مرّر series_ الذي تكون قيمة 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.
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.
هل كانت هذه الصفحة مفيدة؟