نظرة سريعة
يستخدم المثال مرشح العطلات الوطنية في Calendarific ومسار الدولة والسنة للولايات المتحدة في Narwhal.
| المتطلب | واجهة Narwhal API | Calendarific |
|---|---|---|
| الباقة المجانية | ✓ رصيد مجاني بقيمة $10 شهريًا لمدة 12 شهرًا، دون بطاقة | ✓ 500 استدعاء شهريًا؛ مع الإسناد |
| أرخص باقة مدفوعة | شحن يبدأ من $20؛ من $2 إلى $10 لكل 1,000 استدعاء | Starter: $12 شهريًا؛ و$100 سنويًا متاحة |
| سرعة التحديث | وفق جدول كل مجموعة بيانات؛ تُحفظ الطوابع الزمنية | المجانية: ربع سنوي؛ Enterprise: يومي |
| السجل | السجل الكامل لكل حساب؛ السجلات المتاحة فقط | المجانية: سنوات ماضية وقادمة محدودة |
| التغطية | البيانات الاقتصادية والعملات والعطلات والسلع المنشورة | أكثر من 230 دولة وأكثر من 3,300 منطقة |
| الواجهات | REST وMCP؛ WebSocket غير منشور | REST؛ WebSocket وMCP غير منشورين |
| حزم SDK | ✓ حزم SDK رسمية لـ Python وTypeScript | غير منشورة |
| الاستخدام التجاري في الباقة المجانية | ✓ التطبيقات التجارية مسموحة؛ وإعادة البيع تتطلب اتفاقًا مخصصًا | غير منشورة؛ الإسناد مطلوب في المجانية |
السعر بحسب استخدامك
تتيح Starter الدفع الشهري، بينما تتطلب Enterprise دفعًا سنويًا وتغطي 50 مليون استدعاء شهريًا.
| عدد الطلبات شهرياً | واجهة Narwhal API | Calendarific |
|---|---|---|
| 1,000 | $2.00 بسعر $2 لكل 1,000 استدعاء | Starter: $12 شهريًا |
| 10,000 | $20.00 بسعر $2 لكل 1,000 استدعاء | Starter: $12 شهريًا |
| 100,000 | $200.00 بسعر $2 لكل 1,000 استدعاء | Enterprise: $4,000 سنويًا |
انتقل في بضع دقائق
عرض العطلات الرسمية في الولايات المتحدة لعام 2026
Calendarific
# Change: URL and key
curl --get \
"https://calendarific.com/api/v2/holidays" \
--data-urlencode "api_key=YOUR_API_KEY" \
--data-urlencode "country=US" \
--data-urlencode "year=2026" \
--data-urlencode "type=national"واجهة 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 دولة. اجلب سنة كاملة أو ابحث عن تاريخ أو اعثر على العطلة التالية عبر ثلاث عمليات موثّقة. وأضف تواريخ إصدار البيانات الاقتصادية والعملات إلى سير العمل نفسه، بحساب واحد لمنطق الجدولة وبيانات الدول.
متى يكون الخيار الآخر أفضل
يُعدّ Calendarific الخيار الأفضل لتغطية العطلات في أكثر من 230 دولة و3,300 منطقة. يضم كتالوجه العطلات الوطنية والمناسبات المحلية والأعياد الدينية، مع مرشحات لتضييق النتائج. وتلغي خطة Starter شرط الإسناد وتتضمن البيانات التاريخية والقادمة كاملة، وتضيف Enterprise تحديثات يومية. ويناسب هذا النطاق المنتجات المبنية أساسًا على معلومات العطلات الإقليمية، خاصةً حين تكون سعة التغطية هي العامل الحاسم.
أسئلة شائعة
هل يوجد بديل مجاني لـ Calendarific؟
نعم. تمنح Narwhal كل حساب رصيدًا مجانيًا بقيمة $10 شهريًا لمدة 12 شهرًا، مع السماح باستخدام التطبيقات التجارية والوصول عبر REST وMCP المستضاف. استخدم العطلات الرسمية مع جداول إصدار البيانات الاقتصادية والعملات في تطبيق واحد.
كيف تختلف التحديثات والإسناد بحسب الخطة؟
تذكر Calendarific تحديثات ربع سنوية لمجموعات البيانات في Free وStarter، وأسبوعية في Business، ويومية في Enterprise. وتلغي Starter شرط الإسناد وتتضمن 10,000 استدعاء شهريًا، بتكلفة $12 مع الدفع الشهري أو $100 مع الدفع السنوي؛ أما Enterprise فتُحاسَب سنويًا وتتضمن 50 مليون استدعاء شهريًا.
ما الذي يتغيّر في تطبيقي؟
استبدل عنوان الطلب والمصادقة، ثم اربط استجابة JSON بحقول تطبيقك. تستخدم الأمثلة fetch القياسي في JavaScript وrequests في Python، فيناسب التكامل أي عميل HTTP عادي. احتفظ بمفتاحك على الخادم، وانقل وحدات الاستجابة وتواريخها وقيمها المفقودة إلى العرض أو الحسابات.
ماذا يحدث عند نفاد رصيد Narwhal؟
يُشارَك رصيد بين استدعاءات REST وMCP. عندما يصل إلى الصفر تُرجع الواجهة HTTP 402 `insufficient_credits`، ولا يمكن أن تُحاسَب بأكثر من رصيدك. لا يُرحَّل الرصيد المجاني، وينتهي الرصيد المدفوع بعد 12 شهرًا من آخر شحن.
تمت المراجعة: