التاريخ والوقت

العطل الرسمية API

اعرض العطل الرسمية لأي بلد وسنة مدعومين بالأسماء المحلية والإنجليزية.

طلب الرؤوس

Name	Required	Description
`X-RapidAPI-Key`	required	Your RapidAPI key. Get one free.
`X-RapidAPI-Host`	required	`holidays.p.rapidapi.com`

نقاط النهاية

GET /v1/holidays

List public holidays for a country and year

حدود

Name	Type	Required	Default	Constraints
`country`	string	required	—	matches \S
`year`	integer	optional	—	2020-2035

أمثلة على الكود

curl --request GET \
  --url 'https://holidays.p.rapidapi.com/v1/holidays?country=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: holidays.p.rapidapi.com'

const url = "https://holidays.p.rapidapi.com/v1/holidays?country=example";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "holidays.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://holidays.p.rapidapi.com/v1/holidays"

querystring = {"country": "example"}

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "holidays.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())

GET /v1/holidays/countries

List all countries that have holidays in the dataset, sorted alphabetically by ISO code.

أمثلة على الكود

curl --request GET \
  --url 'https://holidays.p.rapidapi.com/v1/holidays/countries' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: holidays.p.rapidapi.com'

const url = "https://holidays.p.rapidapi.com/v1/holidays/countries";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "holidays.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://holidays.p.rapidapi.com/v1/holidays/countries"

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "holidays.p.rapidapi.com"
}

response = requests.get(url, headers=headers)

print(response.json())

مثال تفاعلي

holidays

$ GET /v1/holidays?country=US&year=2025
{"data":[{"date":"2025-07-04","local_name":"Independence Day","name":"Independence Day","country":"US","types":["Public"]}],"meta":{"total":1,"limit":1,"offset":0}}

الاشتراك والترخيص

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

عرض الأسعار والاشتراك

دعم المطورين

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

تواصل مع هندسة API

أداء النظام

مراقبة على مدار 24 ساعة طوال أيام الأسبوع مع وقت تشغيل بنسبة 99.9% لاتفاقية مستوى الخدمة. تم تصميمه فوق خدمات صغيرة سحابية أصلية مع تخزين مؤقت على الحافة موزع عالميًا لضمان أوقات استجابة منخفضة للغاية.

جميع الأنظمة التشغيلية