كيف تحصل على مفتاح API مجاني لأسعار الصرف (ومتى لا تحتاجه)

إجابتان صادقتان، الأقصر أولا. لتجربة الواجهة البرمجية لا تحتاج مفتاحا: كل نقطة نهاية بيانات — /v1/latest و/v1/convert و/v1/range و/v1/{date} — تجيب على الطلبات المجهولة بمعدل 12 طلبا في الدقيقة و100 في الساعة لكل عنوان IP. لأي شيء يعمل وفق جدول أو يُشحن لأشخاص آخرين، سجّل في exchangerate.dev/signup، وأكّد بريدك الإلكتروني، وانسخ المفتاح الذي يبدأ بـexr_live_ من لوحة التحكم. الطبقة المجانية: 10,000 استدعاء شهريا، 12 طلبا في الدقيقة، سنة واحدة من السجل التاريخي، دون بطاقة ائتمان.

مسار دون مفتاح: جرّب الواجهة البرمجية أولا

قبل إنشاء أي شيء، استدعِ الواجهة البرمجية وانظر إلى حمولة حقيقية. يعمل هذا من أي طرفية دون تسجيل:

# No key, no signup — works at 12 req/min, 100 req/hour per IP
curl -s https://api.exchangerate.dev/v1/latest/USD

# A single pair, converted
curl -s https://api.exchangerate.dev/v1/convert/USD/JPY/250

يحمل كل رد source وmarket_session، لذا يمكنك رؤية ما إذا كان السعر توافقا فوريا أو تثبيت البنك المركزي الأوروبي اليومي قبل أن تقرر أي شيء. يمكنك أيضا تشغيل الاستدعاء نفسه في المتصفح وقراءة JSON هناك.

احصل على المفتاح المجاني

• افتح exchangerate.dev/signup وسجّل ببريدك الإلكتروني. لا خطوة بطاقة ائتمان.
• أكّد البريد الإلكتروني. تفتح لوحة تحكمك مع مفتاح API مهيّأ مسبقا.
• انسخ المفتاح — يبدأ بـexr_live_. هذه البادئة هي كيف تتعرّف عليه في الإعدادات لاحقا.

الطبقة المجانية هي 10,000 استدعاء شهريا بمعدل 12 طلبا في الدقيقة، مع سنة واحدة من السجل اليومي وأسعار حية حيث تتوفر التغطية الحية. هذه جودة البيانات نفسها التي تقرؤها الطبقات المدفوعة — تختلف الطبقات بالحجم ومعدل الطلبات، لا بالحداثة.

استخدم المفتاح: ترويسات، لا روابط أبدا

مرّر المفتاح في ترويسة. Authorization: Bearer هي الصيغة الأساسية؛ توجد X-API-Key للموصّلات التي لا تستطيع ضبط ترويسة Authorization (بعض أدوات ذكاء الأعمال ومنصات بلا كود):

# Primary form
curl -s https://api.exchangerate.dev/v1/latest/USD \
  -H "Authorization: Bearer exr_live_your_key_here"

# Fallback for connectors without Authorization support
curl -s https://api.exchangerate.dev/v1/latest/USD \
  -H "X-API-Key: exr_live_your_key_here"

أبقِ المفتاح خارج سلاسل الاستعلام، وخارج حزم JavaScript من جهة العميل، وخارج نظام التحكم بالإصدارات. في كود التطبيق، اقرأه من متغيّر بيئة؛ ولواجهة أمامية عامة، مرّر الاستدعاءات عبر وسيط صغير من جهة الخادم كي لا يصل المفتاح إلى المتصفح أبدا.

أي مسار تحتاجه فعلا؟