جميع واجهات API

واجهة API للتواريخ والتقويمات

الإجازات الرسمية وجداول الإصدارات الاقتصادية والتقويمات المشترك فيها.

الطلب الأول

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",
  "coverage": [
    {
      "scope": "collective_leave",
      "subdivision_codes": []
    },
    {
      "scope": "national_public",
      "subdivision_codes": []
    }
  ],
  "holiday": {
    "date": "2026-08-17",
    "name": "Independence Day",
    "local_name": "Proklamasi Kemerdekaan",
    "subdivision_codes": [],
    "scope": "national_public"
  }
}

نقاط النهاية

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

GETاعرض عطلات سنة منشورة./v1/calendars/holidays/{country}/{year}

مرجع API ‏←

GETاعثر على العطلات في تاريخ./v1/calendars/holidays/{country}/on/{date}

مرجع API ‏←

GETاعثر على العطلة التالية./v1/calendars/holidays/{country}/next

مرجع API ‏←

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

GETاعرض الإصدارات ضمن نطاق زمني./v1/economics/calendar

مرجع API ‏←

GETاقرأ إصدارًا، مع إمكانية تحديد version_id./v1/economics/calendar/{release_id}

مرجع API ‏←

موجزات تقويم العطلات والإصدارات الاقتصادية

POSTأنشئ اشتراكًا باستخدام مفتاح Narwhal API الخاص بك لتحصل على عنوان URL لموجز ICS، الذي يُعاد مرة واحدة فقط./v1/calendars/subscriptions

مرجع API ‏←

GETاجلب موجز ICS./v1/calendars/subscriptions/{token}.ics

مرجع API ‏←

DELETEألغِ اشتراكًا./v1/calendars/subscriptions/{subscription_id}

مرجع API ‏←

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

العطلات المنشورة

تحتفظ التقويمات الرسمية بالنطاق الوطني والإقليمي وتواريخ التعطيل المعتمدة وتعريفات المصدر.

اقرأ المنهجية ‏←

جداول الإصدارات

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

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

تقدم موجزات ICS القابلة للإلغاء الأحداث المحددة. وتتحكم تطبيقات التقويم في توقيت التحديث.

التغطية

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

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