جميع واجهات API

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

تابع الإصدارات الاقتصادية المجدولة وحالة نشرها. أنشئ تقويم إصدارات للناتج المحلي الإجمالي والأسعار وسوق العمل والتجارة ومنحنيات العائد دون اعتبار المواعيد غير المؤكدة أوقاتًا دقيقة.

الطلب الأول

دليل البدء السريع ‏←
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-10-01&end_date=2026-10-31" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا
{
  "status": "ok",
  "snapshot": "calendar-snapshot-20260914",
  "as_of": "2026-09-14T08:00:00Z",
  "releases": [
    {
      "release_id": "00000000-0000-4000-8000-000000000201",
      "series_id": "usa-consumer-prices",
      "country": "USA",
      "name": "Consumer prices",
      "topic": "consumer_prices",
      "title": "Consumer Price Index",
      "period": "2026-09",
      "status": "scheduled",
      "at": "2026-10-14T12:30:00Z",
      "timezone": "America/New_York"
    }
  ],
  "next_cursor": null
}

اشتراكات التقويم

أنشئ موجز ICS للاشتراك عبر Narwhal API للبلدان ونطاق التواريخ اللذين يختارهما فريقك. ضمّن الإجازات الرسمية أو مواعيد الإصدارات الاقتصادية أو كليهما، حسب التغطية المتاحة. استخدمه في تقويم Google أو تقويم Apple أو Outlook أو تطبيقات التقويم الأخرى.

curl --request POST \
  --url "https://api.narwhalapi.com/v1/calendars/subscriptions" \
  --header "Authorization: Bearer $NARWHAL_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"countries":["USA"],"start_date":"2026-09-01","end_date":"2026-12-31","include_releases":true,"include_holidays":true}'
استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا
{
  "subscription_id": "example-subscription",
  "url": "https://api.narwhalapi.com/v1/calendars/subscriptions/EXAMPLE_TOKEN.ics",
  "expires_at": "2026-12-31T23:59:59Z",
  "refresh_note": "calendar clients control refresh latency"
}

نقاط النهاية

GETاعرض الإصدارات ضمن نطاق زمني./v1/economics/calendar
مرجع API ‏←
GETاقرأ إصدارًا، مع إمكانية تحديد version_id./v1/economics/calendar/{release_id}
مرجع API ‏←

كيفية عمل البيانات

خطّط وفق مواعيد الإصدارات

صفِّ التقويم حسب الدول ونطاق التواريخ، ثم تابع معرّفات الإصدارات المُعادة.

افهم الجدول

ميّز بين الأوقات الدقيقة والتواريخ والنطاقات المقدرة والمواعيد النهائية والجداول المجهولة.

تابع إصدارًا

استرجع إصدارًا ونسخته وفترته المرجعية وحالته والطوابع الزمنية لنشره.

التغطية

عرض التغطية ‏←

لا يضمن الإصدار المجدول النشر في وقت محدد تمامًا. حافظ على دقة الجدول الزمني والمنطقة الزمنية، وتعامل صراحةً مع الإصدارات الملغاة. وتصف الطوابع الزمنية للنشر والطوابع الزمنية للرصد حدثين مختلفين.

استكشف الصفحات ذات الصلة

واجهة API للعطلات الرسمية

احصل على الإجازات الرسمية حسب البلد والسنة عبر REST أو MCP. تحقق من تاريخ أو اعثر على العطلة التالية مع نطاق وطني وإقليمي.

استكشف API ‏←

الأسئلة الشائعة

هل لكل إصدار وقت دقيق؟

لا. قد يحدد الناشر تاريخًا أو نطاقًا أو موعدًا نهائيًا فقط. ويحافظ كائن الجدول على تلك الدقة.

هل يمكنني استرجاع نسخة سابقة؟

استخدم المعلمة version_id في طلب تفاصيل الإصدار لاختيار نسخة غير قابلة للتغيير.

أجرِ أول طلب لك

احصل على مفتاح API مجاني ‏←