جميع واجهات API

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

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

الطلب الأول

دليل البدء السريع ‏←
curl --request GET \
  --url "https://api.narwhalapi.com/v1/calendars/holidays/IDN/next?from_date=2026-08-01" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا
{
  "country": "IDN",
  "from_date": "2026-08-01",
  "coverage": [
    {
      "scope": "national_public",
      "nationwide": true,
      "subdivision_codes": []
    },
    {
      "scope": "collective_leave",
      "nationwide": true,
      "subdivision_codes": []
    }
  ],
  "holiday": {
    "date": "2026-08-17",
    "name": "Independence Day",
    "local_name": "Hari Kemerdekaan",
    "subdivision_codes": [],
    "nationwide": true,
    "observed": null,
    "scope": "national_public"
  }
}

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

أنشئ موجز 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/calendars/holidays/{country}/{year}
مرجع API ‏←
GETاعثر على العطلات في تاريخ./v1/calendars/holidays/{country}/on/{date}
مرجع API ‏←
GETاعثر على العطلة التالية./v1/calendars/holidays/{country}/next
مرجع API ‏←

المصادر والمنهجية

تحقّق من تاريخ

اعثر على عطلات يوم محدد مع الحفاظ على النطاق الوطني والإقليمي.

اعثر على العطلة القادمة

اطلب العطلة التالية من تاريخ مختار بدلًا من فحص سنة كاملة.

التغطية

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

راجع المرجع لمعرفة تغطية الدول والسنوات المنشورة. وتظل الأحداث الوطنية والإقليمية مميزة عن بعضها. ولا تعني الإجازة الرسمية إغلاق البنوك أو البورصات أو أنظمة التسوية.

ARGAUSBRACANCHNDEUFRAGBRHKGIDNITAJPNINDMEXNLDNZLKORRUSSAUSGPTURESTIRLLVALTUUSAZAFPOLCZESVNHRVPRTAUTBELCOLDNKESPLUXNORSVKSWETWNPHL

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

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

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

استكشف API ‏←

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

هل تشمل العطلات الإقليمية؟

عندما تشمل التغطية المنشورة أحداثًا إقليمية، تحتفظ الاستجابة بالتقسيمات الإدارية التي تنطبق عليها تلك الأحداث.

ماذا يحدث إذا كانت الدولة أو السنة مفقودة؟

يُرجع طلب تقويم خارج نطاق التغطية المتاح خطأً. ولا يعني ذلك عدم وجود عطلات في الدولة.

هل يعني العيد الرسمي أن البنوك أو الأسواق مغلقة؟

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

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

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