API v1 · مستقر · CC-BY-4.0

واجهة العطل الفنلندية

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

جرّبه

أمر curl واحد وملف JSON واحد. لا مفاتيح ولا تسجيل.

terminalجلسة مثال · الاستجابة مختصرة

$ curl https://vapaapaivat.com/api/v1/fi/holidays/2026.json
# 200 OK · application/json

{
  "apiVersion": "1",
  "jurisdiction": "FI",
  "year": 2026,
  "timezone": "Europe/Helsinki",
  "holidays": [
    {
      "id": "newyear",
      "date": "2026-01-01",
      "name": {
        "fi": "Uudenvuodenpäivä",
        "en": "New Year's Day",
        "sv": "Nyårsdagen",
        "et": "uusaasta",
        "ru": "Новый год",
        "uk": "Новий рік",
        "ar": "رأس السنة الميلادية"
      },
      "official": true,
      "weekend": false,
      "businessDay": false
    }
  ]
}

المسارات

يعيد مساران ملف JSON واحدًا لكل سنة. اختر مسارًا لرؤية بنيته.

GETالعطل /api/v1/fi/holidays/{year}.json GETعطل نهاية أسبوع طويلة /api/v1/fi/long-weekends/{year}.json

نموذج العنوان: GET /api/v1/fi/holidays/{year}.json

مثال: https://vapaapaivat.com/api/v1/fi/holidays/2026.json

التواريخ والأسماء وما إذا كان كل تاريخ عطلة رسمية أو نهاية أسبوع أو يوم عمل. استخدم سنة من 2000 إلى 2099. يمثل مقطع /fi/ في العنوان فنلندا.

استجابة المستوى الأعلى

الحقل	النوع	الوصف
`apiVersion`	string	إصدار API
`jurisdiction`	string	البلد، FI
`year`	number	السنة التقويمية
`timezone`	string	المنطقة الزمنية Europe/Helsinki
`holidays`	array	حقول عنصر العطلة

حقول عنصر العطلة

الحقل	النوع	الوصف
`id`	string	معرف ثابت للعطلة
`date`	string	تاريخ ISO بصيغة YYYY-MM-DD
`name`	object	الأسماء باللغات fi و sv و en و ar و ru و uk و et
`official`	boolean	عطلة رسمية
`weekend`	boolean	تقع يوم السبت أو الأحد
`businessDay`	boolean	يوم عمل فنلندي

نموذج العنوان: GET /api/v1/fi/long-weekends/{year}.json

مثال: https://vapaapaivat.com/api/v1/fi/long-weekends/2026.json

أيام إجازة يمكن أن تحول العطل ونهايات الأسبوع إلى فترات راحة أطول. استخدم سنة من 2000 إلى 2099. يمثل مقطع /fi/ في العنوان فنلندا.

استجابة المستوى الأعلى

الحقل	النوع	الوصف
`apiVersion`	string	إصدار API
`jurisdiction`	string	البلد، FI
`year`	number	السنة التقويمية
`timezone`	string	المنطقة الزمنية Europe/Helsinki
`longWeekends`	array	حقول عنصر العطلة الطويلة

حقول عنصر العطلة الطويلة

الحقل	النوع	الوصف
`startDate`	string	بداية فترة الراحة، YYYY-MM-DD
`endDate`	string	نهاية فترة الراحة، YYYY-MM-DD
`vacationDays`	string[]	أيام الإجازة المستخدمة
`vacationDayCount`	number	عدد أيام الإجازة
`totalDaysOff`	number	عدد أيام الراحة المتتالية
`efficiency`	number	أيام الراحة لكل يوم إجازة
`season`	string	winter أو summer

jsonالاستجابة · مختصرة

{
  "apiVersion": "1",
  "jurisdiction": "FI",
  "year": 2026,
  "longWeekends": [
    {
      "startDate": "2026-04-03",
      "endDate": "2026-04-06",
      "vacationDays": [],
      "vacationDayCount": 0,
      "totalDaysOff": 4,
      "efficiency": null,
      "season": "spring"
    }
  ]
}

الاستقرار

الإصدار v1 مستقر. تُنشر السنوات الجديدة كل نوفمبر. تبقى الإضافات غير الكاسرة في v1؛ أما التغييرات الكاسرة فتُنشر ضمن /api/v2/.

هل لاحظت تاريخًا خاطئًا أو لغة ناقصة؟ أبلغ عنه. هل تبحث عن بيانات العطل المدرسية للبلديات؟ راجع datasets. openapi.json