الطلبات القياسية
توثيق لنقطة نهاية API الخاصة بأسعار صرف العملات القياسية.
نظرة عامة
تُعد نقطة نهاية API القياسية الخاصة بنا أسرع وأسهل طريقة للوصول إلى بيانات أسعار الصرف لدينا. وهي متاحة ضمن جميع الخطط بما في ذلك الخطة المجانية.
اختر عملتك الأساسية وستُرجع نقطة النهاية القياسية أسعار الصرف من رمز عملتك الأساسية إلى جميع العملات الأخرى التي ندعمها، في صيغة JSON سهلة التحليل.
دليل الاستخدام
لاستخدام نقطة النهاية القياسية لدينا، قم ببساطة بإجراء الاستبدالات الموضحة أدناه ثم أرسل طلب GET.
• استبدل YOUR-API-KEY
بمفتاح API المعروض في لوحة التحكم الخاصة بك.
• استبدل USD
بالرمز الذي تريد استخدامه كعملة أساسية.
نحن نستخدم رموز العملات المكونة من ثلاثة أحرف وفقًا لمعيار ISO 4217 - مثل USD للدولار الأمريكي، وEUR لليورو، إلخ. للمزيد من التفاصيل حول الرموز المدعومة، يمكنك الاطلاع على الرموز المدعومة.
GET https://api.currencyexchangerate-api.com/v1/YOUR-API-KEY/latest/USD
سيُرجع هذا الطلب أسعار الصرف من رمز عملتك الأساسية إلى جميع العملات الأخرى التي ندعمها:
{
"result": "success",
"base_code": "USD",
"qouta": 100,
"remining": 81,
"conversion_rates": {
"USD": 1,
"AED": 3.6725,
"AFN": 71.3023,
"ALL": 93.9532,
"AMD": 387.9516,
"ANG": 1.79,
"AOA": 864.5035,
"ARS": 902.67,
"AUD": 1.512,
"AWG": 1.79,
"AZN": 1.7007,
"BAM": 1.8274,
"BBD": 2,
"BDT": 117.582,
"BGN": 1.8274,
"BHD": 0.376,
"BIF": 2867.3971,
"BMD": 1,
"BND": 1.3532,
"BOB": 6.9345,
"BRL": 5.3659,
"BSD": 1,
"BTN": 83.5845,
"BWP": 13.6479,
"BYN": 3.2726,
"BZD": 2,
"CAD": 1.3735,
"CDF": 2811.1817,
"CHF": 0.8908,
"CLP": 918.097,
"CNY": 7.2761,
"COP": 4125.4698,
"CRC": 527.8638,
"CUP": 24,
"CVE": 103.0222,
"CZK": 23.0881,
"DJF": 177.721,
"DKK": 6.9697,
"DOP": 59.6961,
"DZD": 134.8695,
"EGP": 47.7066,
"ERN": 15,
"ETB": 57.711,
"EUR": 0.9343,
"FJD": 2.2419,
"FKP": 0.7889,
"FOK": 6.9697,
"GBP": 0.7889,
"GEL": 2.8683,
"GGP": 0.7889,
"GHS": 15.1395,
"GIP": 0.7889,
"GMD": 65.5045,
"GNF": 8590.3598,
"GTQ": 7.7857,
"GYD": 209.2441,
"HKD": 7.8123,
"HNL": 24.7901,
"HRK": 7.0396,
"HTG": 132.4625,
"HUF": 371.7429,
"IDR": 16460.2009,
"ILS": 3.721,
"IMP": 0.7889,
"INR": 83.5835,
"IQD": 1310.1654,
"IRR": 42104.4774,
"ISK": 139.5748,
"JEP": 0.7889,
"JMD": 155.8355,
"JOD": 0.709,
"JPY": 157.4773,
"KES": 128.4461,
"KGS": 86.9658,
"KHR": 4128.9042,
"KID": 1.5118,
"KMF": 459.6528,
"KRW": 1381.9946,
"KWD": 0.3067,
"KYD": 0.8333,
"KZT": 451.9814,
"LAK": 21616.4732,
"LBP": 89500,
"LKR": 303.7975,
"LRD": 194.9098,
"LSL": 18.37,
"LYD": 4.8584,
"MAD": 9.9799,
"MDL": 17.7768,
"MGA": 4462.0936,
"MKD": 57.5767,
"MMK": 2098.8668,
"MNT": 3375.0857,
"MOP": 8.0465,
"MRU": 39.4135,
"MUR": 46.647,
"MVR": 15.4143,
"MWK": 1743.0533,
"MXN": 18.495,
"MYR": 4.7187,
"MZN": 63.8439,
"NAD": 18.37,
"NGN": 1513.7314,
"NIO": 36.9489,
"NOK": 10.6821,
"NPR": 133.7351,
"NZD": 1.6295,
"OMR": 0.3845,
"PAB": 1,
"PEN": 3.7789,
"PGK": 3.8447,
"PHP": 58.7065,
"PKR": 278.5415,
"PLN": 4.0841,
"PYG": 7520.7635,
"QAR": 3.64,
"RON": 4.6567,
"RSD": 109.4952,
"RUB": 89.4676,
"RWF": 1316.4133,
"SAR": 3.75,
"SBD": 8.4695,
"SCR": 14.5658,
"SDG": 532.5211,
"SEK": 10.5305,
"SGD": 1.3533,
"SHP": 0.7889,
"SLE": 22.9677,
"SLL": 22967.6967,
"SOS": 571.7521,
"SRD": 31.7386,
"SSP": 1793.3311,
"STN": 22.8907,
"SYP": 12983.3643,
"SZL": 18.37,
"THB": 36.6731,
"TJS": 10.7228,
"TMT": 3.5003,
"TND": 3.1451,
"TOP": 2.3551,
"TRY": 32.7864,
"TTD": 6.7952,
"TVD": 1.5118,
"TWD": 32.3454,
"TZS": 2600.6585,
"UAH": 40.6506,
"UGX": 3722.7985,
"UYU": 39.2902,
"UZS": 12586.5842,
"VES": 36.4176,
"VND": 25434.6838,
"VUV": 119.7204,
"WST": 2.7294,
"XAF": 612.8705,
"XCD": 2.7,
"XDR": 0.7609,
"XOF": 612.8705,
"XPF": 111.4937,
"YER": 250.2642,
"ZAR": 18.3681,
"ZMW": 26.2162,
"ZWL": 3.4803
}
}
استجابات الأخطاء
{
"result": "error",
"error-type": "unknown-code"
}
حيث يمكن أن يكون "error-type" أي مما يلي:
- unsupported-code: إذا لم ندعم رمز العملة المُقدم (انظر العملات المدعومة...).
- malformed-request: عندما لا يتبع جزء من طلبك الهيكل الموضح أعلاه.
- invalid-key: عندما يكون مفتاح API الخاص بك غير صالح.
- inactive-account: إذا لم يتم تأكيد عنوان بريدك الإلكتروني.
- quota-reached: عندما يصل حسابك إلى الحد المسموح به من الطلبات وفقًا لخطة اشتراكك.
Need Help?
If you have any questions or need further assistance, don’t hesitate to contact us. We’re here to assist you!