الأسئلة الشائعة
البداية
كيف أحصل على مفتاح API؟
أنشئ حسابًا مجانيًا وولّد مفتاحًا من لوحة التحكم. لا تحتاج بطاقة ائتمان للخطة المجانية.
كيف أصادق على الطلبات؟
مرّر مفتاحك في مسار الرابط (/api/v1/YOUR_KEY/latest) أو في ترويسة Authorization: Bearer أو X-API-Key.
ما صيغ الردود المدعومة؟
JSON افتراضيًا، إضافة إلى XML وCSV عبر المُعامل ?format=. تُضغط الردود الأكبر من 1KB بصيغة gzip.
البيانات والتغطية
كم عملة تغطّون؟
أكثر من 160 عملة عالمية، لكلٍّ منها اسم ورمز وبيانات منازل عشرية.
كم مرة تُحدَّث الأسعار؟
نفحص مصادرنا كل ساعة، ويتغيّر السعر عندما ينشر مصدره سعرًا جديدًا: لمعظم العملات مرة في كل يوم عمل (ينشر البنك المركزي الأوروبي نحو الساعة 16:00 بتوقيت وسط أوروبا)، لذا تبقى الأسعار ثابتة ليلًا وفي عطلات نهاية الأسبوع. تعرض صفحة الحالة وقت آخر تحديث.
هل يمكنني التحويل بين عملتين غير USD؟
نعم. تُخزَّن الأسعار مقابل USD وتُحتسب الأسعار التقاطعية تلقائيًا، فتعمل أزواج مثل GBP→JPY مباشرة.
هل تقدّمون أسعارًا تاريخية ومشفّرة؟
نعم - الأسعار التاريخية وأسعار العملات المشفّرة متاحة على خطة Pro وأعلى.
الخطط والحدود
هل توجد خطة مجانية؟
نعم، تتضمن الخطة المجانية 2,500 طلب شهريًا دون بطاقة.
ما حدود المعدّل؟
تتدرّج الحدود في الدقيقة مع خطتك (Free 10، Pro 100، Business/Enterprise 1000). كل رد يتضمن ترويسات X-RateLimit.
هل يمكنني تغيير الخطة في أي وقت؟
نعم. تسري التغييرات فورًا وتُحدَّث حصتك الشهرية على الفور.
كيف أتابع استخدامي؟
تعرض لوحة التحكم استخدام الشهر الحالي، وتعيده نقطتا /usage و/quota برمجيًا.
الموثوقية والدعم
ماذا يحدث عند بلوغ الحد؟
تتلقى ردًا 429 مع ترويسة Retry-After. رقِّ خطتك لحدود أعلى.
هل ينكسر تكاملي عند التحديثات؟
لا - روابط legacy وv1 وv2 تظل تعمل. نُصدِر إصدارات الواجهة لترقّي على وتيرتك.
كيف أحصل على المساعدة؟
تواصل معنا عبر صفحة الاتصال؛ تحظى الخطط المدفوعة بدعم أولوية.
لا يزال لديك سؤال؟ راسلنا