(API) واجهة برمجية متكاملة لتقديم مفاتيح api باللغة العربية لحساب العمر وتحويل التواريخ بين التقويمين الهجري والميلادي وغيرها مع دعم كامل للغة العربية
توثيق API احصل على مفتاح APIحساب العمر بالتقويمين الهجري والميلادي بدقة عالية مع تقديم معلومات تفصيلية عن العمر بالسنوات والشهور والأيام.
تحويل التواريخ بسهولة بين التقويمين الهجري والميلادي باستخدام خوارزميات دقيقة لضمان صحة التحويل.
حساب عمر الطفل مع عرض المراحل التنموية المهمة والنصائح المناسبة لكل مرحلة عمرية.
معلومات تفصيلية عن الأبراج والصفات الشخصية المرتبطة بها بناءً على تاريخ الميلاد.
نصائح صحية وتوصيات خاصة بكل مرحلة عمرية مع معلومات حيوية مثل معدل النوم المناسب وتوصيات التغذية.
توليد رسائل تهنئة مخصصة لأعياد الميلاد باللغة العربية مع إمكانية تخصيص الرسالة باسم المستخدم.
واجهة برمجة التطبيقات (API) توفر مجموعة من النقاط النهائية (Endpoints) للتعامل مع حسابات العمر وتحويل التواريخ وأسعار المعادن والعملات. تستخدم واجهة برمجة التطبيقات بروتوكول HTTP وتستجيب بتنسيق JSON.
لاستخدام واجهة برمجة التطبيقات، يجب تضمين مفتاح API الخاص بك في رأس الطلب (Header) باستخدام X-API-KEY.
يحسب العمر بناءً على تاريخ الميلاد بالتقويمين الهجري والميلادي.
| المعلمة | النوع | الوصف | إلزامي |
|---|---|---|---|
| birthdate | string | تاريخ الميلاد بتنسيق "DD-MM-YYYY" | نعم |
| calendar_type | string | نوع التقويم المستخدم: "hijri" أو "gregorian" | نعم |
يحسب عمر الطفل ويعرض المراحل التنموية المهمة.
| المعلمة | النوع | الوصف | إلزامي |
|---|---|---|---|
| birthdate | string | تاريخ ميلاد الطفل بتنسيق "DD-MM-YYYY" | نعم |
| calendar_type | string | نوع التقويم المستخدم: "hijri" أو "gregorian" | نعم |
يحسب الفرق بين تاريخي ميلاد شخصين.
| المعلمة | النوع | الوصف | إلزامي |
|---|---|---|---|
| first_birthdate | string | تاريخ الميلاد الأول بتنسيق "DD-MM-YYYY" | نعم |
| second_birthdate | string | تاريخ الميلاد الثاني بتنسيق "DD-MM-YYYY" | نعم |
| calendar_type | string | نوع التقويم المستخدم: "hijri" أو "gregorian" | نعم |
يحول التاريخ بين التقويمين الهجري والميلادي.
| المعلمة | النوع | الوصف | إلزامي |
|---|---|---|---|
| date | string | التاريخ بتنسيق "DD-MM-YYYY" | نعم |
| from | string | التقويم المصدر: "hijri" أو "gregorian" | نعم |
| to | string | التقويم الهدف: "hijri" أو "gregorian" | نعم |
يعرض معلومات وصفات البرج بناءً على تاريخ الميلاد.
| المعلمة | النوع | الوصف | إلزامي |
|---|---|---|---|
| birthdate | string | تاريخ الميلاد بتنسيق "DD-MM-YYYY" | نعم |
| calendar_type | string | نوع التقويم المستخدم: "hijri" أو "gregorian" | نعم |
يولد رسالة تهنئة مخصصة لعيد الميلاد.
| المعلمة | النوع | الوصف | إلزامي |
|---|---|---|---|
| name | string | اسم الشخص المراد تهنئته | نعم |
توفر واجهة برمجة التطبيقات إمكانية الوصول إلى أسعار الذهب والفضة بمختلف العيارات، وأسعار صرف العملات لمجموعة متنوعة من الدول. يتم تحديث الأسعار بشكل دوري من مصادر موثوقة.
يمكنك استخدام هذه البيانات في تطبيقاتك أو مواقعك لعرض أحدث أسعار المعادن والعملات.
يوفر أسعار المعادن (الذهب والفضة) حسب المعلمات المحددة.
| المعلمة | النوع | الوصف | إلزامي |
|---|---|---|---|
| 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
}
]
}
يوفر أسعار الذهب حسب العيار والدولة والتاريخ.
| المعلمة | النوع | الوصف | إلزامي |
|---|---|---|---|
| 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
}
]
}
يوفر أسعار الفضة حسب نقاء الفضة والدولة والتاريخ.
| المعلمة | النوع | الوصف | إلزامي |
|---|---|---|---|
| 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
}
]
}
يوفر أسعار صرف العملات مقابل الدولار الأمريكي.
| المعلمة | النوع | الوصف | إلزامي |
|---|---|---|---|
| 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
}
]
}
الدول والعملات المدعومة حاليًا:
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 | خطأ في الخادم الداخلي |
شهريًا
شهريًا
شهريًا