تبدو معظم واجهات أسعار الصرف المجانية متشابهة: JSON ورمز وقائمة عملات. تظهر الفروق عند تحديث المصدر، وعند بلوغ الحد، وعندما يحتاج الكود إلى معرفة عمر القيمة.
- افحص الحصة الشهرية وحد الطلبات في الدقيقة قبل تشغيل مهمة مجدولة.
- الحداثة خلال اليوم تميز القيمة المرجعية اليومية عن القيمة التي تتبع حركة السوق.
- توضح
sourceوmarket_sessionوdata_updated_atنوع البيانات ووقتها. - قد يبدأ السجل اليومي في 1999 عندما تتوفر مشاهدات للزوج.
- يقلل
/v1/convertوخادم MCP من كود الربط المتكرر.
لماذا نقارن الأبعاد بدل الترتيب
تعرض القوائم المرتبة تفضيل الكاتب في يوم الكتابة. أما المقارنة بُعداً بعد بُعد فتوضح ما يلائم مشروعك: لوحة تحتاج مرجعاً يومياً تختلف عن تطبيق يعرض الأسعار طوال اليوم.
البعد 1: الحصة المجانية وحد الطلبات
تحدد الحصة مدة التجربة أو التشغيل الصغير مجاناً، ويحدد حد الدقيقة ما إذا كانت مهمة الدفعة تحتاج إلى إعادة محاولة. لا يفرض موجز ECB العام حصة API، لكنه XML ويتحدث مرة في كل يوم عمل. مشاريع JSON الثابتة مثل fawazahmed0/exchange-api لا تقدم خادماً خاصاً أو بيانات حداثة أو تحديثاً خلال اليوم. تقبل exchangerate.dev الطلبات المجهولة مع حد لكل IP؛ والمفتاح المجاني يمنح 5,000 طلب شهرياً و10 في الدقيقة.
احسب الطلبات أولاً. طلب السعر مع كل تحميل صفحة يستهلك طلباً لكل زيارة. اجمع العملات في symbols عندما يكون ذلك ممكناً.
البعد 2: الحداثة خلال اليوم
ينشر ECB السعر نحو 16:00 CET في أيام العمل. يتحدث live كل 60 ثانية تقريبًا خلال أسبوع التداول. تصل أسعار Free والطلبات دون مفتاح بتأخير 15 دقيقة، والمدفوعة مباشرة. يوضح market_session حالة السوق.
البعد 3: بيانات الحداثة
للتخزين المؤقت، استخدم data_updated_at لا وقت الرد. market_daily إغلاق يومي محفوظ لتغذية السوق للعملات بلا تثبيت ECB.
source:live,ecb_daily,market_dailymarket_session: حالة سوق ما بين البنوك.data_updated_at: آخر وقت كُتبت فيه البيانات الأساسية، وهو مختلف عنtimestamp.is_forward_filled: يبين أن قيمة اليوم السابق نُقلت لأن اليوم لم يشهد قيمة منشورة.
البعد 4: عمق السجل التاريخي
تتيح Free والطلبات دون مفتاح آخر 30 يومًا من السجل اليومي، وBasic آخر سنة. تتيح Plus وPro السجل الكامل من 1999 حسب الزوج. استخدم مفتاحًا مع /v1/{date}/{base} أو /v1/range للسجل الأعمق.
البعد 5: نقطة تحويل مدمجة
يعيد GET /v1/convert/USD/EUR/100 الحقول rate وconverted وderived في طلب واحد. يعالج POST /v1/convert التحويلات المجمعة، بما فيها الأزواج المحسوبة مثلثياً.
البعد 6: دعم الوكلاء وMCP
يحتاج وكيل الذكاء الاصطناعي إلى تعريفات أدوات منظمة. يتوفر خادم MCP في https://api.exchangerate.dev/v1/mcp بأدوات منها start_checkout وlist_currencies وget_rate وget_usd_index وconvert وget_range وsearch_docs. يتطلب Checkout تأكيداً بشرياً ويستخدم حصة REST نفسها.
الأبعاد الستة جنباً إلى جنب
| البعد | موجز ECB المرجعي | exchangerate.dev (الخطة المجانية) |
|---|---|---|
| الحصة الشهرية | لا توجد حصة في الموجز العام | 5,000 طلب شهرياً، 10 في الدقيقة |
| الحداثة اليومية | آخر تثبيت حتى يوم العمل التالي | Free ودون مفتاح: تأخير 15 دقيقة |
| بيانات الحداثة | طابع زمني | source وmarket_session وdata_updated_at |
| السجل | سلاسل XML منشورة منذ نحو 1999 | آخر 30 يومًا من السجل اليومي |
| التحويل | لا توجد نقطة تحويل | /v1/convert وPOST مجمع |
| الوكلاء / MCP | لا يوجد خادم MCP أصلي | خادم MCP بأدوات |
اختيار الملاءمة الصحيحة
إذا احتجت مرجعاً يومياً فقط وتستطيع قراءة XML، فقد يكفي موجز ECB العام. إذا احتجت حركة خلال اليوم أو حقول المصدر أو السجل أو التحويل أو أدوات الوكلاء، راجع تغطية الأزواج وحدود الخطة المجانية في exchangerate.dev.
الواجهة المناسبة هي التي تناسب حدودها حالة استخدامك، لا التي تملك أطول قائمة ميزات.