← العودة إلى المدونة

واجهة أسعار صرف العملات المجانية: المصادر والتغطية والحدود

واجهة أسعار صرف العملات المجانية: المصادر والتغطية والحدود

فيمَ تفيد واجهة أسعار الصرف المجانية

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

بُنيت نقاط نهاية العملات في ipto على هذه الفكرة. يمكنك تجربة البيانات نفسها في محوّل العملات، أو استدعاؤها من الشيفرة عبر /v1/currency/convert و/v1/currency/rates و/v1/currency/history، وهي موصوفة في وثائق API.

من أين تأتي الأسعار

المصدر الرئيسي هو مجموعة البيانات المفتوحة fawazahmed0/currency-api. وهي ضمن الملك العام، ولا تتطلب مفتاح API، وتُحدَّث يوميًا. تُقدَّم من شبكتَي محتوى مستقلتين، ويجرّبهما ipto بالترتيب، فلا يوقف تعطل إحداهما تحديث الأسعار. تحدّث الخدمة البيانات وفق جدول يومي وتحتفظ بالنتيجة في ذاكرة مؤقتة سريعة، فلا ينتظر التحويل في الصفحة طلبًا خارجيًا.

أما أسعار الصرف المرجعية التي ينشرها البنك المركزي الأوروبي فهي أمر مختلف، وتُستخدم هنا احتياطيًا فقط. فإذا تعذّر الوصول إلى شبكتَي المصدر الرئيسي كلتيهما، يواصل ipto تقديم نحو 31 عملة رئيسية ينشرها البنك المركزي الأوروبي، بدلًا من فقدان بيانات الأسعار كليًا. وفي التشغيل العادي لا تنظر إلى بيانات البنك المركزي الأوروبي.

التغطية

يدعم ipto عدد 154 عملة عالمية، جرى اختيارها من قائمة مصدر أكبر بكثير. يحتوي المصدر أيضًا على عملات مشفّرة ووحدات محاسبية ليست عملات للدفع، وقد استُبعدت عمدًا. ولكل عملة مدعومة اسم وعلم، ليعرض لك المحوّل شيئًا مقروءًا بدلًا من رمز مجرد.

السجل التاريخي

تُرجع نقطة نهاية السجل أسعارًا مرجعية يومية لزوج عملات خلال آخر 30 أو 60 أو 90 يومًا، وهو ما يرسمه المخطط في صفحة المحوّل أيضًا. يفيد السجل في رصد اتجاه ما، والتحقق من السعر في يوم تسجيل معاملة، وفحص رقم يبدو خاطئًا. وهو نافذة مدتها 90 يومًا، وليس أرشيفًا لعدة سنوات. وإذا كنت بحاجة إلى أسعار تعود إلى عام 1999 لأعمال التدقيق، فاستخدم مصدرًا ينشر ذلك الأرشيف واحتفظ بنسخة منه.

حدود ينبغي أن تخطط لها

  • يومي وليس مباشرًا. السعر قيمة يومية واحدة. لا تستخدمه للتداول أو لتسوية دفعة.
  • بلا رسوم أو هوامش. تضيف المصارف وشبكات البطاقات فارق سعر. وستختلف التكلفة الفعلية على عميلك عن السعر المرجعي.
  • عطلات نهاية الأسبوع والعطلات الرسمية. تعامل مع اليوم المفقود على أنه آخر سعر متاح، لا على أنه خطأ.
  • عمر الذاكرة المؤقتة. قد يبلغ عمر الأسعار يومًا كاملًا بحكم التصميم. اعرض التاريخ بجوار أي مبلغ محوَّل.

استخدامها مع تحديد الموقع الجغرافي لعنوان IP

أكثر الاستخدامات شيوعًا أن تكتشف بلد الزائر من عنوان IP الخاص به عبر نقطة نهاية البحث عن IP، التي تُرجع أيضًا عملة ذلك البلد، ثم تحوّل أسعارك إليها. ولأن تحديد الموقع الجغرافي تقريبي، دع الزائر دائمًا يغيّر العملة بنفسه، وتذكّر أن الزائر عبر VPN قد يظهر وكأنه في بلد آخر، وهو ما يمكن أن يساعدك فاحص VPN على اكتشافه.

الخلاصة

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

إجابات مباشرة

ليس كمصدر رئيسي. تأتي الأسعار من مجموعة بيانات مفتوحة تُحدَّث يوميًا وتغطي 154 عملة. ولا تُستخدم الأسعار المرجعية للبنك المركزي الأوروبي (نحو 31 عملة رئيسية) إلا احتياطيًا في حالات الطوارئ إذا تعذّر الوصول إلى المصدر الرئيسي.
أسعار مرجعية يومية لآخر 30 أو 60 أو 90 يومًا لأي زوج عملات مدعوم، ومتاحة في مخطط صفحة المحوّل وعبر نقطة نهاية السجل.
لا. إنها أسعار مرجعية يومية ولا تشمل رسوم المصارف أو البطاقات. استخدمها للعرض والتقديرات وإعداد التقارير، لا للتداول أو تسوية المدفوعات.
← العودة إلى المدونة