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

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

توثيق API احصل على مفتاح API
صورة توضيحية

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

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

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

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

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

حساب عمر الطفل

حساب عمر الطفل مع عرض المراحل التنموية المهمة والنصائح المناسبة لكل مرحلة عمرية.

صفات الأبراج

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

معلومات صحية

نصائح صحية وتوصيات خاصة بكل مرحلة عمرية مع معلومات حيوية مثل معدل النوم المناسب وتوصيات التغذية.

تهاني أعياد الميلاد

توليد رسائل تهنئة مخصصة لأعياد الميلاد باللغة العربية مع إمكانية تخصيص الرسالة باسم المستخدم.

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

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

اطلب مفتاح API

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

مقدمة

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

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

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

POST حساب العمر

/api/calculate-age

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

المعلمات:
المعلمة النوع الوصف إلزامي
birthdate string تاريخ الميلاد بتنسيق "DD-MM-YYYY" نعم
calendar_type string نوع التقويم المستخدم: "hijri" أو "gregorian" نعم

POST حساب عمر الطفل

/api/calculate-baby-age

يحسب عمر الطفل ويعرض المراحل التنموية المهمة.

المعلمات:
المعلمة النوع الوصف إلزامي
birthdate string تاريخ ميلاد الطفل بتنسيق "DD-MM-YYYY" نعم
calendar_type string نوع التقويم المستخدم: "hijri" أو "gregorian" نعم

POST حساب فرق العمر

/api/calculate-age-difference

يحسب الفرق بين تاريخي ميلاد شخصين.

المعلمات:
المعلمة النوع الوصف إلزامي
first_birthdate string تاريخ الميلاد الأول بتنسيق "DD-MM-YYYY" نعم
second_birthdate string تاريخ الميلاد الثاني بتنسيق "DD-MM-YYYY" نعم
calendar_type string نوع التقويم المستخدم: "hijri" أو "gregorian" نعم

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

/api/convert-date

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

المعلمات:
المعلمة النوع الوصف إلزامي
date string التاريخ بتنسيق "DD-MM-YYYY" نعم
from string التقويم المصدر: "hijri" أو "gregorian" نعم
to string التقويم الهدف: "hijri" أو "gregorian" نعم

POST صفات البرج

/api/zodiac-traits

يعرض معلومات وصفات البرج بناءً على تاريخ الميلاد.

المعلمات:
المعلمة النوع الوصف إلزامي
birthdate string تاريخ الميلاد بتنسيق "DD-MM-YYYY" نعم
calendar_type string نوع التقويم المستخدم: "hijri" أو "gregorian" نعم

POST تهنئة عيد الميلاد

/api/birthday-wish

يولد رسالة تهنئة مخصصة لعيد الميلاد.

المعلمات:
المعلمة النوع الوصف إلزامي
name string اسم الشخص المراد تهنئته نعم
معلومات عن أسعار المعادن والعملات

توفر واجهة برمجة التطبيقات إمكانية الوصول إلى أسعار الذهب والفضة بمختلف العيارات، وأسعار صرف العملات لمجموعة متنوعة من الدول. يتم تحديث الأسعار بشكل دوري من مصادر موثوقة.

يمكنك استخدام هذه البيانات في تطبيقاتك أو مواقعك لعرض أحدث أسعار المعادن والعملات.

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

/api/metal-prices

يوفر أسعار المعادن (الذهب والفضة) حسب المعلمات المحددة.

المعلمات:
المعلمة النوع الوصف إلزامي
metal string نوع المعدن: "gold" أو "silver" (الافتراضي: "gold") لا
country string رمز الدولة (مثال: "saudi", "egypt") (الافتراضي: "saudi") لا
karat string عيار الذهب: "24", "21", "18", "14", "12", "9", "all" (الافتراضي: "24") لا
date string تاريخ محدد لجلب البيانات (بتنسيق: YYYY-MM-DD) لا
period string الفترة الزمنية: "daily", "weekly", "monthly", "3months", "6months", "yearly" (الافتراضي: "daily") لا
limit integer عدد السجلات المطلوبة (الحد الأقصى: 1000، الافتراضي: 10) لا
language string لغة العرض: "ar" أو "en" (الافتراضي: "ar") لا
مثال للاستجابة:
{
  "status": "success",
  "country": "المملكة العربية السعودية",
  "currency": "ريال سعودي",
  "currency_code": "SAR",
  "karat": "24",
  "last_updated": "2023-04-18 10:30:45",
  "data": [
    {
      "date": "2023-04-18",
      "time": "10:30:45",
      "buy_price": 243.87,
      "sell_price": 256.06,
      "source": "yahoo",
      "is_max_buy": true,
      "is_min_buy": false,
      "is_max_sell": true,
      "is_min_sell": false
    }
  ]
}

POST أسعار الذهب

/api/gold-prices

يوفر أسعار الذهب حسب العيار والدولة والتاريخ.

المعلمات:
المعلمة النوع الوصف إلزامي
country string رمز الدولة (مثال: "saudi", "egypt") (الافتراضي: "saudi") لا
karat string عيار الذهب: "24", "21", "18", "14", "12", "9", "all" (الافتراضي: "24") لا
date string تاريخ محدد لجلب البيانات (بتنسيق: YYYY-MM-DD) لا
period string الفترة الزمنية: "daily", "weekly", "monthly", "3months", "6months", "yearly" (الافتراضي: "daily") لا
limit integer عدد السجلات المطلوبة (الحد الأقصى: 1000، الافتراضي: 10) لا
language string لغة العرض: "ar" أو "en" (الافتراضي: "ar") لا
مثال للاستجابة عند طلب جميع العيارات:
{
  "status": "success",
  "country": "المملكة العربية السعودية",
  "currency": "ريال سعودي",
  "currency_code": "SAR",
  "karat": "all",
  "last_updated": "2023-04-18 10:30:45",
  "data": [
    {
      "date": "2023-04-18",
      "time": "10:30:45",
      "karats": {
        "24k": {
          "buy_price": 243.87,
          "sell_price": 256.06
        },
        "21k": {
          "buy_price": 213.39,
          "sell_price": 224.06
        },
        "18k": {
          "buy_price": 182.90,
          "sell_price": 192.05
        },
        "14k": {
          "buy_price": 142.25,
          "sell_price": 149.37
        },
        "12k": {
          "buy_price": 121.94,
          "sell_price": 128.03
        },
        "9k": {
          "buy_price": 91.45,
          "sell_price": 96.02
        }
      },
      "source": "yahoo",
      "is_max_buy": true,
      "is_min_buy": false,
      "is_max_sell": true,
      "is_min_sell": false
    }
  ]
}

POST أسعار الفضة

/api/silver-prices

يوفر أسعار الفضة حسب نقاء الفضة والدولة والتاريخ.

المعلمات:
المعلمة النوع الوصف إلزامي
country string رمز الدولة (مثال: "saudi", "egypt") (الافتراضي: "saudi") لا
purity string نقاء الفضة: "999", "958", "925", "900", "875", "800", "all" (الافتراضي: "999") لا
date string تاريخ محدد لجلب البيانات (بتنسيق: YYYY-MM-DD) لا
period string الفترة الزمنية: "daily", "weekly", "monthly", "3months", "6months", "yearly" (الافتراضي: "daily") لا
limit integer عدد السجلات المطلوبة (الحد الأقصى: 1000، الافتراضي: 10) لا
language string لغة العرض: "ar" أو "en" (الافتراضي: "ar") لا
مثال للاستجابة:
{
  "status": "success",
  "country": "المملكة العربية السعودية",
  "currency": "ريال سعودي",
  "currency_code": "SAR",
  "purity": "999",
  "last_updated": "2023-04-18 10:30:45",
  "data": [
    {
      "date": "2023-04-18",
      "time": "10:30:45",
      "buy_price": 3.12,
      "sell_price": 3.43,
      "is_max_buy": true,
      "is_min_buy": false,
      "is_max_sell": true,
      "is_min_sell": false
    }
  ]
}

POST أسعار العملات

/api/currency-rates

يوفر أسعار صرف العملات مقابل الدولار الأمريكي.

المعلمات:
المعلمة النوع الوصف إلزامي
currency string رمز العملة (مثال: "SAR", "EGP") أو رمز الدولة (مثال: "saudi", "egypt") (الافتراضي: "SAR") لا
from_currency string رمز العملة المصدر (الافتراضي: "USD") لا
date string تاريخ محدد لجلب البيانات (بتنسيق: YYYY-MM-DD) لا
period string الفترة الزمنية: "daily", "weekly", "monthly", "3months", "6months", "yearly" (الافتراضي: "daily") لا
limit integer عدد السجلات المطلوبة (الحد الأقصى: 1000، الافتراضي: 10) لا
language string لغة العرض: "ar" أو "en" (الافتراضي: "ar") لا
مثال للاستجابة:
{
  "status": "success",
  "from_currency": "USD",
  "to_currency": "SAR",
  "country": "المملكة العربية السعودية",
  "currency_name": "ريال سعودي",
  "last_updated": "2023-04-18 10:30:45",
  "data": [
    {
      "date": "2023-04-18",
      "time": "10:30:45",
      "rate": 3.75264,
      "is_max": true,
      "is_min": false
    }
  ]
}
الدول والعملات المدعومة

الدول والعملات المدعومة حاليًا:

  • saudi - المملكة العربية السعودية (SAR)
  • uae - الإمارات العربية المتحدة (AED)
  • kuwait - الكويت (KWD)
  • qatar - قطر (QAR)
  • oman - عمان (OMR)
  • egypt - مصر (EGP)
  • syria - سوريا (SYP)
  • libya - ليبيا (LYD)
  • lebanon - لبنان (LBP)
  • algeria - الجزائر (DZD)
  • iraq - العراق (IQD)
  • morocco - المغرب (MAD)
  • sudan - السودان (SDG)
  • tunisia - تونس (TND)
  • turkey - تركيا (TRY)

أمثلة على استخدام واجهة البرمجة

curl -X POST "https://your-domain.com/api/gold-prices" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "country": "saudi",
  "karat": "all",
  "period": "daily",
  "language": "ar"
}'
fetch('https://your-domain.com/api/gold-prices', {
  method: 'POST',
  headers: {
    'X-API-KEY': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    country: 'saudi',
    karat: 'all',
    period: 'daily',
    language: 'ar'
  })
})
.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://your-domain.com/api/gold-prices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'country' => 'saudi',
    'karat' => 'all',
    'period' => 'daily',
    'language' => 'ar'
  ]),
  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;
}

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

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

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

خطط الأسعار

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

$0

شهريًا


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

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

الأكثر شعبية

$29

شهريًا


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

خطة الأعمال

$99

شهريًا


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

اتصل بنا