توثيق واجهة برمجة التطبيقات لأسعار صرف العملات لـ PHP

مقدمة في واجهة برمجة التطبيقات لأسعار صرف العملات لـ PHP

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

لماذا تختار واجهة برمجة التطبيقات لأسعار صرف العملات لـ PHP؟

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

توفر واجهتنا استجابات JSON سريعة يُمكن تحليلها بسهولة، وتضمن المكتبات الأصلية لمعالجة JSON في PHP الوصول السلس إلى بيانات أسعار الصرف بأقل جهد ممكن.

للحصول على معلومات مفصلة حول الطلبات المدعومة والميزات، يرجى الرجوع إلى التوثيق الرئيسي.

البداية السريعة: مثال لتحويل العملات في PHP

لبدء الاستخدام، ستحتاج إلى التسجيل للحصول على حساب مجاني للحصول على مفتاح API الخاص بك. سجل هنا للحصول على مفتاحك.

إليك مثال أساسي لكيفية استخدام واجهتنا مع PHP:

// جلب JSON
$req_url = 'https://api.currencyexchangerate-api.com/v1/YOUR-API-KEY/latest/USD';
$response_json = file_get_contents($req_url);
 
// الاستمرار في حال تم الحصول على نتيجة
if(false !== $response_json) {
 
    // استخدام try/catch لعملية json_decode
    try {
 
        // فك التشفير
        $response = json_decode($response_json);
 
        // التحقق من النجاح
        if('success' === $response->result) {
 
            // رمز التطبيق الخاص بك هنا، مثلاً:
            $base_price = 12; // سعرك بالدولار الأمريكي
            $EUR_price = round(($base_price * $response->conversion_rates->EUR), 2);
 
        }
 
    }
    catch(Exception $e) {
        // معالجة خطأ فك تشفير JSON...
    }
 
}

عينة استجابة JSON نموذجية

إليك عينة من استجابة JSON من الواجهة مع الدولار الأمريكي كرمز العملة الأساسي:

{
  "result": "success",
  "base_code": "USD",
  "qouta": 100,
  "remining": 78,
  "conversion_rates": {
    "USD": 1,
    "AED": 3.6725,
    "AFN": 71.3023,
    ...
  }
}

للحصول على تفاصيل إضافية حول أنواع الطلبات، معالجة الأخطاء، والمزيد، يرجى زيارة التوثيق الرئيسي.

هل تحتاج إلى مساعدة؟

إذا كان لديك أي أسئلة أو كنت بحاجة إلى المزيد من المساعدة، لا تتردد في الاتصال بنا. نحن هنا لمساعدتك!