نظرة سريعة
يجلب المثال العطلات الرسمية في الولايات المتحدة لعام 2026؛ وتُحاسَب خطط HolidayAPI المدفوعة سنويًا.
| المتطلب | واجهة Narwhal API | HolidayAPI |
|---|---|---|
| الباقة المجانية | ✓ رصيد مجاني بقيمة $10 شهريًا لمدة 12 شهرًا، دون بطاقة | ✓ مفتاح مجاني؛ الحد غير منشور |
| أرخص باقة مدفوعة | شحن يبدأ من $20؛ من $2 إلى $10 لكل 1,000 استدعاء | Countries: $249/سنة |
| سرعة التحديث | وفق جدول كل مجموعة بيانات؛ تُحفظ الطوابع الزمنية | غير منشورة |
| السجل | السجل الكامل لكل حساب؛ السجلات المتاحة فقط | المدفوعة: من السنة 1 حتى 2050 وما بعدها |
| التغطية | البيانات الاقتصادية والعملات والعطلات والسلع المنشورة | 250 دولة؛ و3,680 تقسيمًا إداريًا في الخطة الأعلى |
| الواجهات | REST وMCP؛ WebSocket غير منشور | REST؛ WebSocket وMCP غير منشورين |
| حزم SDK | ✓ حزم SDK رسمية لـ Python وTypeScript | ✓ مكتبة Node رسمية |
| الاستخدام التجاري في الباقة المجانية | ✓ التطبيقات التجارية مسموحة؛ وإعادة البيع تتطلب اتفاقًا مخصصًا | غير منشورة؛ والخطة المدفوعة تشمل الاستخدام التجاري |
السعر بحسب استخدامك
تشمل Countries مليون طلب شهريًا والاستخدام التجاري، وتُحاسَب بمبلغ $249 مقدمًا سنويًا.
| عدد الطلبات شهرياً | واجهة Narwhal API | HolidayAPI |
|---|---|---|
| 1,000 | $2.00 بسعر $2 لكل 1,000 استدعاء | Countries: $249/سنة |
| 10,000 | $20.00 بسعر $2 لكل 1,000 استدعاء | Countries: $249/سنة |
| 100,000 | $200.00 بسعر $2 لكل 1,000 استدعاء | Countries: $249/سنة |
انتقل في بضع دقائق
عرض العطلات الرسمية في الولايات المتحدة لعام 2026
HolidayAPI
# Change: URL and key
curl --get \
"https://holidayapi.com/v1/holidays" \
--data-urlencode "key=YOUR_API_KEY" \
--data-urlencode "country=US" \
--data-urlencode "year=2026"واجهة Narwhal API
# Change: URL and key
url="https://api.narwhalapi.com"
url="$url/v1/calendars/holidays/USA/2026"
curl \
"$url" \
-H "Authorization: Bearer YOUR_API_KEY"لماذا ينتقل الفرق
ابدأ البناء مجانًا
يحصل كل حساب في Narwhal على رصيد مجاني بقيمة $10 شهريًا لمدة 12 شهرًا، مع السماح بالتطبيقات التجارية. استخدم هذا الرصيد للوحة معلومات أو لجلب بيانات مجدول أو لتكامل مع وكيل. ومع نمو الاستخدام أضف شحنًا يبدأ من $20، بالحساب والمصادقة نفسيهما.
اربط تطبيقك ووكيلك
يصل REST وMCP المستضاف إلى البيانات نفسها عبر حساب واحد. يستطيع تطبيقك جلب JSON بينما يستخدم الوكيل الأدوات المستضافة، ويُحاسَب كل استدعاء مرة واحدة من الرصيد المشترك. ومع رصيد واحد يسهل تقدير ميزانية الحمل المجمّع.
اجمع مهام التقويم معًا
تنشر Narwhal عطلات 48 دولة. اجلب سنة كاملة أو ابحث عن تاريخ أو اعثر على العطلة التالية عبر ثلاث عمليات موثّقة. وأضف تواريخ إصدار البيانات الاقتصادية والعملات إلى سير العمل نفسه، بحساب واحد لمنطق الجدولة وبيانات الدول.
متى يكون الخيار الآخر أفضل
يُعدّ HolidayAPI الخيار الأفضل لتغطية واسعة للعطلات في مناطق ولغات متعددة. تغطي خطة Countries 250 دولة وأكثر من 100 لغة، وتضيف States & Provinces 3,680 تقسيمًا إداريًا. وتتضمن الخطتان المدفوعتان الاستخدام التجاري ومليون طلب شهريًا دون تقييد للسرعة. وإذا كانت مهمة منتجك الرئيسية تقويم عطلات محلّيًا لمناطق كثيرة، فهذا الكتالوج المتخصص مناسب جدًا.
أسئلة شائعة
هل يوجد بديل مجاني لـ HolidayAPI؟
نعم. تمنح Narwhal كل حساب رصيدًا مجانيًا بقيمة $10 شهريًا لمدة 12 شهرًا، مع السماح باستخدام التطبيقات التجارية والوصول عبر REST وMCP المستضاف. وتدعم واجهة العطلات البحث بالسنة والتاريخ والعطلة التالية عبر الحساب نفسه.
ماذا تتضمن خطة Countries؟
تشمل خطة Countries السنوية بسعر $249 مليون طلب شهريًا والاستخدام التجاري وعطلات السنوات من 1 حتى 2050 وما بعدها. ويمكن للمشتركين المدفوعين حفظ نسخة غير متصلة ما دام اشتراكهم ساريًا. وتحدّ الخطة المجانية التخزين دون اتصال بـ 24 ساعة، ولا تذكر الأسعار المنشورة حصة طلبات شهرية مجانية.
ما الذي يتغيّر في تطبيقي؟
استبدل عنوان الطلب والمصادقة، ثم اربط استجابة JSON بحقول تطبيقك. تستخدم الأمثلة fetch القياسي في JavaScript وrequests في Python، فيناسب التكامل أي عميل HTTP عادي. احتفظ بمفتاحك على الخادم، وانقل وحدات الاستجابة وتواريخها وقيمها المفقودة إلى العرض أو الحسابات.
ماذا يحدث عند نفاد رصيد Narwhal؟
يُشارَك رصيد بين استدعاءات REST وMCP. عندما يصل إلى الصفر تُرجع الواجهة HTTP 402 `insufficient_credits`، ولا يمكن أن تُحاسَب بأكثر من رصيدك. لا يُرحَّل الرصيد المجاني، وينتهي الرصيد المدفوع بعد 12 شهرًا من آخر شحن.
تمت المراجعة: