جميع واجهات 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",
  "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"
  }
}

نقاط النهاية

GETاعرض سنة منشورة/v1/calendars/holidays/{country}/{year}
GETتحقّق من تاريخ/v1/calendars/holidays/{country}/on/{date}
GETابحث عن العطلة التالية/v1/calendars/holidays/{country}/next

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

ثلاث عمليات بحث مفيدة

أضف تعليقات إلى التقارير، واعرض العطلات القادمة، وأضف سياق التاريخ المحلي إلى إجابة الوكيل.

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

النطاق الوطني والإقليمي

اعرف ما إذا كان الحدث ينطبق على الصعيد الوطني أو على التقسيمات المسماة فقط.

التغطية التي يمكنك التحقق منها

تُدرج السنوات المنشورة ونطاقها الدقيق في مرجع التقويم. وتظل الدول والسنوات الأخرى غير متاحة صراحةً مع توسع الهدف إلى تسع عشرة دولة.

لا تعني العطلات الرسمية إغلاق البنوك أو البورصات أو أسواق التسوية. وتظل الأحداث الإقليمية ظاهرة، وقد تكون حالة يوم التعويض غير معروفة، ويؤدي نقص تغطية التقويم إلى إرجاع خطأ بدلًا من تاريخ مُخمَّن.

أدلة المطورين

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

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