أجرِ أول طلب للبيانات الاقتصادية

أبقِ المفتاح خارج عنوان URL

خزّن مفتاح Narwhal بوصفه سرًا أو متغير بيئة. أرسله في ترويسة Authorization باعتباره رمز Bearer. لا تضعه في سلسلة استعلام أو تلتزم به في مستودع أو تكشفه في كود المتصفح.

استدعِ نقطة نهاية CPI

اترك الفترة لاسترجاع أحدث إصدار مكتمل مقبول.

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

اقرأ الاستجابة

الاستجابة JSON محددة النوع من دون غلاف بيانات عام. وتأتي القيم العشرية في صورة سلاسل نصية كي لا يفقد العملاء الدقة بصمت. وتظل القيم المفقودة مفقودة ولا تتحول إلى صفر.

{
  "country": "USA",
  "period": "2026-07",
  "value": "333.918",
  "base_period": "1982-84",
  "base_value": "100",
  "released_on": "2026-08-12"
}

غيّر الدولة أو العملية

استبدل USA بـ AUS أو CAN أو DEU أو FRA أو GBR أو JPN أو MYS أو NLD أو SGP لطلب المقياس نفسه لبلد آخر متاح مباشرةً. واستبدل cpi بمسار عملية موثّق آخر للتضخم أو البطالة أو المشاركة في قوة العمل أو GDP أو نمو GDP أو التجارة أو الصادرات أو الواردات.

تعامل مع الأخطاء حسب الحالة والرمز

تعني استجابة 400 أن الطلب غير صالح. وتعني 401 أن مفتاح API مفقود أو غير صالح. وتعني 404 أن المسار أو السلسلة المطلوبة غير متاحة. وتعني 429 استنفاد الحصة. وتعني 503 تعذر تقديم البيانات أو الخدمة المطلوبة بأمان في تلك اللحظة.

تستخدم أجسام الأخطاء application/problem+json وتتضمن معرّف الطلب. أعد محاولة استجابتي 500 و503 مع تراجع محدود. أصلح استجابتي 400 و401 قبل المحاولة مجددًا، وانتظر إعادة الضبط الموثقة قبل إعادة محاولة 429.

تستخدم REST وMCP البيانات نفسها

تستخدم أدوات MCP المفتاح نفسه والإصدارات المخزنة ومخططات الاستجابة وحصة البيانات نفسها التي تستخدمها REST. اختر الواجهة المناسبة لتطبيقك؛ فالبيانات الاقتصادية الأساسية واحدة.