العطلات الرسمية عبر API
استعلم عن العطلات الرسمية لأكثر من 100 دولة وأي سنة في استدعاء API واحد. حساب محلي بالكامل — دون مصادر بيانات خارجية، ودون مفاجآت في حدود المعدّل.
لا تملك مفتاح API؟
سجّل الدخول إلى حسابك لإنشاء وإدارة مفاتيح API.
دليل التكامل
انسخ المقتطف، استبدل مفتاح API الخاص بك، ثم شغّله. يعمل مع أي عميل HTTP — أمثلة أدناه بـ cURL وJavaScript وPython.
/api/holidayshttps://www.apipick.comGet all public holidays for a country and year
countrystringمطلوبISO 3166-1 alpha-2 country code US
yearintegerاختياري4-digit year (defaults to current year) 2026
curl -X GET "https://www.apipick.com/api/holidays" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"code": 200,
"message": "Holidays retrieved successfully",
"data": {
"country": "US",
"country_name": "United States",
"year": 2026,
"total": 11,
"holidays": [
{
"date": "2026-01-01",
"name": "New Year's Day"
},
{
"date": "2026-01-19",
"name": "Martin Luther King Jr. Day"
},
{
"date": "2026-02-16",
"name": "Presidents' Day"
},
{
"date": "2026-05-25",
"name": "Memorial Day"
},
{
"date": "2026-07-03",
"name": "Independence Day (observed)"
},
{
"date": "2026-09-07",
"name": "Labor Day"
},
{
"date": "2026-10-12",
"name": "Columbus Day"
},
{
"date": "2026-11-11",
"name": "Veterans Day"
},
{
"date": "2026-11-26",
"name": "Thanksgiving Day"
},
{
"date": "2026-12-25",
"name": "Christmas Day"
}
]
},
"credits_used": 1,
"remaining_credits": 99
}مبني للجدولة في العالم الواقعي
جدولة الموارد البشرية
استبعِد العطلات الرسمية تلقائيًا عند حساب أرصدة الإجازات ودورات الرواتب وجداول المناوبات عبر دول متعددة.
تقاويم التداول
تخطَّ أيام عدم التداول في النماذج المالية والاختبارات الرجعية. حدّد العطلات المصرفية التي تؤثّر في نوافذ التسوية والمقاصّة.
أوقات الوصول المقدّرة للوجستيات
احسب تقديرات تسليم دقيقة بتخطّي العطلات تلقائيًا في دول المنشأ والعبور والوجهة.
أتمتة n8n
اربطه بسير عمل n8n أو Zapier لضبط الإجراءات الحسّاسة للوقت — تخطَّ إرسال رسائل البريد أو التقارير في العطلات الوطنية.
بديل HolidayAPI وNager.Date
بيانات السنة الحالية، والتخطيط للسنوات المستقبلية، واتفاقية مستوى خدمة إنتاجية — دون قفل السنة في المستوى المجاني أو خطر الاعتماد على مشروع مجتمعي.
HolidayAPI | Nager.Date | API Pick ✓ | |
|---|---|---|---|
| المستوى المجاني | السنة السابقة فقط | مجاني (دون اتفاقية مستوى خدمة) | 100 رصيد عند التسجيل |
| بيانات السنة الحالية | الخطة المدفوعة فقط | ✓ | ✓ |
| بيانات السنوات المستقبلية | الخطة المدفوعة فقط | ✓ (محدود) | ✓ حتى +10 سنوات |
| البيانات التاريخية (من 1900) | الخطة المدفوعة فقط | جزئي | ✓ من 1900 |
| اتفاقية مستوى الخدمة الإنتاجية | الخطط المدفوعة فقط | ✗ مشروع مجتمعي | ✓ |
| الدول المُغطّاة | ~100 | ~110 | 100+ |
| لا حاجة إلى بطاقة ائتمان للبدء | ✗ | ✓ | ✓ |
| هل تنتهي صلاحية الأرصدة / الطلبات؟ | خطة سنوية | N/A | لا تنتهي أبدًا |
| جاهز لوكلاء الذكاء الاصطناعي / نماذج اللغة | جزئي | جزئي | ✓ JSON أصلي |
فخّ المستوى المجاني في HolidayAPI
الخطة المجانية لـ HolidayAPI مقيّدة عمدًا بـ السنة التقويمية السابقة فقط. هل تحتاج إلى البحث عن عطلات السنة الحالية أو التخطيط مسبقًا لجداول إجازات 2027؟ يجب أن تترقّى إلى خطة مدفوعة. وبالنسبة لأي حالة استخدام تتعلّق بالجدولة أو الأتمتة، يجعل هذا المستوى المجاني عديم الفائدة عمليًا من اليوم الأول.
خطر الموثوقية في Nager.Date
Nager.Date مشروع مفتوح المصدر مُدار من قِبل المجتمع — مجاني الاستخدام لكن مع عدم وجود اتفاقية مستوى خدمة لزمن التشغيل، ولا عقد دعم، ولا ضمان لاستمرار التوفّر. الفرق التي بنت أنظمة رواتب أو أنابيب لوجستيات عليه فوجئت بأعطال غير متوقعة أو إيقاف للخدمة. مناسب للنماذج الأولية؛ لا للإنتاج.
حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
| data.country | string | رمز الدولة ISO 3166-1 alpha-2 (بأحرف كبيرة) |
| data.country_name | string | اسم الدولة الكامل بالإنجليزية |
| data.year | integer | السنة التقويمية المُستعلَم عنها |
| data.total | integer | عدد العطلات الرسمية في السنة |
| data.holidays | array | قائمة كائنات العطلات مرتّبة حسب التاريخ |
| data.holidays[].date | string | تاريخ العطلة بصيغة YYYY-MM-DD |
| data.holidays[].name | string | الاسم الرسمي للعطلة |
| credits_used | integer | الأرصدة المخصومة عن هذا الطلب |
| remaining_credits | integer | الأرصدة المتبقية في حسابك |
حدود المعدل
يُطبَّق التقييد لكل مفتاح API، بنافذة منزلقة مدتها 60 ثانية. عند بلوغ الحد تحصل على رمز 429 نظيف مع ترويسة Retry-After.
120req/min
لكل مفتاح API ولكل نقطة نهاية. نافذة منزلقة مدتها 60 ثانية.
3concurrent
الحد الأقصى للطلبات الجارية المتزامنة لكل مفتاح API.
X-RateLimit-Limitالحد الأقصى للطلبات المسموح بها في الدقيقةX-RateLimit-Remainingالطلبات المتبقية في النافذة الحاليةX-RateLimit-Resetعدد الثواني حتى إعادة ضبط النافذة الحاليةRetry-Afterعدد الثواني التي يجب انتظارها قبل إعادة المحاولة (عند 429 فقط)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}الأسئلة الشائعة
س: ما الدول المدعومة؟
ج: أكثر من 100 دولة عبر مكتبة python-holidays (vacanza) مفتوحة المصدر. ويشمل ذلك الولايات المتحدة والمملكة المتحدة وألمانيا وفرنسا واليابان والصين وأستراليا وكندا والهند والبرازيل ومعظم أوروبا وآسيا وأمريكا اللاتينية وأفريقيا. استخدم رمز ISO 3166-1 alpha-2 صالحًا (مثل US أو GB أو DE).
س: إلى أي مدى يمكنني الاستعلام في الماضي والمستقبل؟
ج: يمكنك الاستعلام عن أي سنة من 1900 حتى 10 سنوات في المستقبل. تُحسب العطلات التاريخية بناءً على القواعد التي كانت سارية في حينها، فتعكس النتائج الاحتفالات التاريخية الفعلية بدلًا من إسقاط قواعد اليوم على الماضي.
س: هل تُدرَج العطلات الإقليمية/المحلية للولايات؟
ج: تُعيد هذه النقطة العطلات الرسمية الوطنية فقط. لا تُدرَج الاحتفالات الخاصة بالولايات أو المقاطعات أو المناطق (مثل عطلات الولايات الأمريكية أو عطلات الولايات الألمانية Länder) في الاستجابة الافتراضية. تواصل معنا إذا كنت بحاجة إلى بيانات عطلات على مستوى التقسيمات الفرعية.
س: هل يمكن لوكلاء الذكاء الاصطناعي استخدامها كأداة؟
ج: نعم. تأخذ نقطة النهاية معاملي استعلام (country وyear) وتُعيد مصفوفة JSON منظّمة — يسهُل تعريفها كأداة دالة لـ OpenAI أو Claude أو LangChain أو أي إطار عمل وكلاء. مثالي لوكلاء الجدولة الذين يحتاجون إلى الاستدلال على أيام العمل عبر دول متعددة.
استخدِم العطلات الرسمية في Claude Code ووكلاء الذكاء الاصطناعي
ثبّت مهارة Claude Code الرسمية للاستعلام عن العطلات الرسمية لأكثر من 100 دولة مباشرةً داخل وكيل البرمجة بالذكاء الاصطناعي — تواريخ مرتّبة وأسماء رسمية وأعداد عبر اللغة الطبيعية.
اسأل وكيل الذكاء الاصطناعي بأسلوب طبيعي
المنصّات المتوافقة
مهارة Claude Code لواجهة العطلات الرسمية من APIpick
تُعيد قوائم العطلات مرتّبة حسب التاريخ مع الأسماء الرسمية بالإنجليزية والأعداد الإجمالية لأكثر من 100 دولة. تدعم السنوات من 1900 حتى 10 سنوات قادمة.