طلبات تحويل مزدوج

نظرة عامة

تُعد نقطة نهاية تحويل مزدوج لدينا مفيدة للتطبيقات التي تريد فقط تحويل العملة بين عملتين محددتين ولا تهتم بأي عملات أخرى.

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

دليل الاستخدام

لاستخدام نقطة نهاية تحويل مزدوج لدينا، ببساطة قم بإجراء الاستبدالات الموضحة أدناه ثم أرسل طلب GET.

• استبدل YOUR-API-KEY بمفتاح API المعروض في لوحة التحكم الخاصة بك.

• استبدل EUR بالرمز الذي تريد استخدامه كعملة أساسية.

• استبدل GBP بالرمز الذي تريد استخدامه كعملة هدف.

نحن نستخدم رموز العملات المكونة من ثلاثة أحرف وفقًا لمعيار ISO 4217 - مثل USD للدولار الأمريكي، وEUR لليورو، إلخ. يمكنك الاطلاع على الرموز المدعومة.

GET https://api.currencyexchangerate-api.com/v1/YOUR-API-KEY/pair/EUR/GBP

سيُرجع هذا طلب سعر الصرف من رمز العملة الأساسي إلى العملة الأخرى التي قمت بتزويدها:

{
    "result": "success",
    "base_code": "USD",
    "target_code": "EGP",
    "qouta": 100,
    "remining": 79,
    "conversion_rate": 47.7066
}

بدلاً من ذلك، يمكنك أيضًا تزويد متغير اختياري AMOUNT (بالصيغة العشرية xxxx.xxxx).

GET https://api.currencyexchangerate-api.com/v1/YOUR-API-KEY/pair/EUR/GBP/AMOUNT

سيُرجع هذا الطلب سعر الصرف من رمز العملة الأساسي إلى العملة الهدف التي قمت بتحديدها، بالإضافة إلى تحويل للكمية التي قمت بتزويدها:

{
    "result": "success",
    "base_code": "USD",
    "target_code": "EGP",
    "qouta": 100,
    "remining": 79,
    "conversion_rate": 47.7066,
    "conversion_result": 47.7066
}

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

{
    "result": "error",
    "error-type": "unknown-code"
}

حيث يمكن أن يكون "error-type" أي مما يلي:

1. unsupported-code: إذا لم ندعم رمز العملة المُقدم (انظر العملات المدعومة...).
2. malformed-request: عندما لا يتبع جزء من طلبك الهيكل الموضح أعلاه.
3. invalid-key: عندما يكون مفتاح API الخاص بك غير صالح.
4. inactive-account: إذا لم يتم تأكيد عنوان بريدك الإلكتروني.
5. quota-reached: عندما يصل حسابك إلى الحد المسموح به من الطلبات وفقًا لخطة اشتراكك.

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

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