API مدير مفاتيح عربي

(API) واجهة برمجية متكاملة لتقديم مفاتيح api باللغة العربية لحساب العمر وتحويل التواريخ بين التقويمين الهجري والميلادي وغيرها مع دعم كامل للغة العربية

صورة توضيحية

مميزات واجهة برمجة التطبيقات

حساب العمر بدقة

حساب العمر بالتقويمين الهجري والميلادي بدقة عالية مع تقديم معلومات تفصيلية.

تحويل التواريخ

تحويل التواريخ بسهولة بين التقويمين الهجري والميلادي باستخدام خوارزميات دقيقة.

أسعار المعادن

احصل على أسعار الذهب والفضة والعملات المختلفة بشكل لحظي ودقيق.

صفات الأبراج

معلومات تفصيلية عن الأبراج والصفات الشخصية المرتبطة بها.

معلومات صحية

نصائح صحية وتوصيات خاصة بكل مرحلة عمرية.

أمان متقدم

حماية طلباتك باستخدام التوقيع الرقمي والتشفير المتقدم.

ابدأ باستخدام API الآن

احصل على مفتاح API واستمتع بجميع المميزات والوظائف المتاحة

اطلب مفتاح API

توثيق واجهة برمجة التطبيقات (API)

مقدمة

واجهة برمجة التطبيقات (API) توفر مجموعة من النقاط النهائية (Endpoints) للتعامل مع حسابات العمر وتحويل التواريخ وأسعار المعادن والعملات. تستخدم واجهة برمجة التطبيقات بروتوكول HTTP وتستجيب بتنسيق JSON.

متطلبات الاستخدام

لاستخدام واجهة برمجة التطبيقات، يجب تضمين مفتاح API الخاص بك في رأس الطلب (Header) باستخدام X-API-KEY.

أمثلة استخدام API

وصف:

حساب العمر بناءً على تاريخ الميلاد بالتقويمين الهجري والميلادي.

المعلمات المطلوبة:
المعلمة الوصف
birthdate تاريخ الميلاد بتنسيق DD-MM-YYYY
calendar_type نوع التقويم (hijri أو gregorian)
مثال للطلب:
{
    "birthdate": "01-01-1990",
    "calendar_type": "gregorian"
}
curl -X POST "https://fikrista.com//api/calculate-age" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "birthdate": "01-01-1990",
    "calendar_type": "gregorian"
}'
fetch('https://fikrista.com//api/calculate-age', {
  method: 'POST',
  headers: {
    'X-API-KEY': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    birthdate: '01-01-1990',
    calendar_type: 'gregorian',
  })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://fikrista.com//api/calculate-age",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'birthdate' => '01-01-1990',
    'calendar_type' => 'gregorian',
  ]),
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: YOUR_API_KEY",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
مثال للاستجابة
{
    "status": "success",
    "data": {
        "gregorian": {
            "birthdate": {
                "date": "1990-01-01",
                "day_name": "الاثنين",
                "month_name": "يناير",
                "day": 1,
                "month": 1,
                "year": 1990
            },
            "current_date": {
                "date": "2025-04-20",
                "day_name": "الأحد",
                "month_name": "أبريل",
                "day": 20,
                "month": 4,
                "year": 2025
            },
            "age": {
                "years": 35,
                "months": 423,
                "weeks": 1842,
                "days": 12900,
                "hours": 309600,
                "minutes": 18576000
            },
            "next_birthday": {
                "date": "2026-01-01",
                "day_name": "الخميس",
                "month_name": "يناير",
                "days_remaining": 256
            }
        },
        "hijri": {
            "birthdate": {
                "date": "05-06-1410",
                "day": 5,
                "month": 6,
                "month_name": "جمادى الآخرة",
                "year": 1410,
                "day_name": "الاثنين"
            },
            "current_date": {
                "date": "20-10-1446",
                "day_name": "الأحد"
            },
            "age": {
                "years": 36,
                "months": 436
            }
        }
    }
}

استجابات الخطأ

في حالة حدوث خطأ، سترجع واجهة برمجة التطبيقات رمز حالة HTTP مناسب ورسالة خطأ.

رمز الحالة الوصف
400 طلب غير صالح (مثل معلمات مفقودة أو غير صالحة)
401 غير مصرح (مفتاح API غير صالح أو مفقود)
403 غير مسموح (المفتاح غير مصرح له بالوصول إلى هذه النقطة النهائية)
404 لم يتم العثور على المورد المطلوب
422 طلب غير صحيح (خطأ في التحقق من المعلمات)
429 عدد كبير جدًا من الطلبات (تم تجاوز حد الاستخدام)
500 خطأ في الخادم الداخلي

خطط الأسعار

الخطة المجانية

$0

شهريًا


  • 100 طلب يوميًا
  • حد 60 طلب في الدقيقة
  • وصول إلى جميع نقاط API
  • بدون دعم فني
  • يتطلب نسبة للخدمة
الأكثر شعبية

الخطة المميزة

$29

شهريًا


  • 10,000 طلب يوميًا
  • حد 300 طلب في الدقيقة
  • وصول إلى جميع نقاط API
  • دعم فني عبر البريد الإلكتروني
  • بدون نسبة للخدمة

خطة الأعمال

$99

شهريًا


  • طلبات غير محدودة
  • حد 1000 طلب في الدقيقة
  • وصول إلى جميع نقاط API
  • دعم فني على مدار الساعة
  • اتفاقية مستوى الخدمة (SLA)

اتصل بنا