الأدلةأدلة

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

يمكنك استدعاء واجهة exchangerate.dev البرمجية دون أي مفتاح؛ 10 طلبات في الدقيقة، مباشرة من curl أو من متصفح. إنشاء مفتاح مجاني يستغرق نحو دقيقة ويرفع ذلك إلى 5,000 استدعاء شهريا بحصتك الخاصة. يعرض هذا الدليل المسارين وأين يتوقف كل منهما.

9 أغسطس 2026 · قراءة 4 دقائق

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

  • لا حاجة لمفتاح للاختبار: كل قراءات البيانات تجيب مجهولة بمعدل 10 طلبات في الدقيقة، 100 في الساعة لكل IP.
  • يُنشأ المفتاح المجاني عند /signup, تأكيد بريد إلكتروني، دون بطاقة ائتمان, وشكله exr_live_....
  • الطبقة المجانية: 5,000 استدعاء شهريا، 10 طلبات في الدقيقة، سجل يومي لآخر 30 يوما، وأسعار حية تصل متأخرة 15 دقيقة.
  • أرسل المفتاح كـAuthorization: Bearer exr_live_...، أو X-API-Key حين يتعذّر على الموصّل ضبط ترويسة Authorization.
  • لا تضع المفتاح أبدا في رابط أو حزمة متصفح عامة, الترويسات فقط، بوساطة خادم للواجهات الأمامية.

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

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

curl · anonymous
# No key, no signup, works at 10 req/min, 100 req/hour per IPcurl -s https://api.exchangerate.dev/v1/latest/USD# A single pair, convertedcurl -s https://api.exchangerate.dev/v1/convert/USD/JPY/250

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

حين يكفي المجهول فعلا

سكربت لمرة واحدة، أو تمرين صفي، أو التحقق من سعر يدويا يقع ضمن 100 طلب في الساعة. إذا كان هذا كل استخدامك، فقد انتهيت, دون مفتاح، ودون شيء تخزّنه أو تدوّره.

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

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

الطبقة المجانية هي 5,000 استدعاء شهريا بمعدل 10 طلبات في الدقيقة، مع سجل يومي لآخر 30 يوما وأسعار حية تصل متأخرة 15 دقيقة. تتلقى الطبقات المدفوعة التغذية نفسها مباشرة؛ وتتلقاها المجانية والطلبات دون مفتاح متأخرة 15 دقيقة، بحصص مختلفة.

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

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

curl · authenticated
# Primary formcurl -s https://api.exchangerate.dev/v1/latest/USD \  -H "Authorization: Bearer exr_live_your_key_here"# Fallback for connectors without Authorization supportcurl -s https://api.exchangerate.dev/v1/latest/USD \  -H "X-API-Key: exr_live_your_key_here"

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

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

الحالةمجهولمفتاح مجاني
تجربة الواجهة البرمجية، فحوصات لمرة واحدةنعم, 10 طلبات/دقيقة لكل IPيعمل أيضا، غير مطلوب
مهمة مجدولة أو تحديث دوريهش, يشارك سقف الـIPنعم؛ حصتك الخاصة 5,000/شهر
مصنّف أو ورقة يحدّثها آخرونلا, عناوين IP الخاصة بهم، سقوفهمنعم, الحصة تتبع المفتاح
منتج تبيعه أو توزّعهنعمرابط إسناد ظاهر (/pricing)
أسعار إرشادية، لا للتسوية

مجهولة أو بمفتاح، التغذية واحدة: بيانات إرشادية لمنتصف السوق للنماذج والتحليل والعرض, لا تسعيرة تداول. يكرر كل رد ذلك في حقل notice.

أسئلة

هل أحتاج مفتاح API للحصول على أسعار الصرف؟

ليس لتجربتها. تجيب كل نقاط نهاية بيانات exchangerate.dev على الطلبات المجهولة بمعدل 10 طلبات في الدقيقة و100 في الساعة لكل IP. تحتاج مفتاحا حين تريد حصتك الخاصة؛ الطبقة المجانية هي 5,000 استدعاء شهريا؛ أو حين تعمل استدعاءاتك وفق جدول أو من أجهزة أشخاص آخرين.

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

نعم. يطلب التسجيل بريدا إلكترونيا فقط؛ دون بطاقة ائتمان. الطبقة المجانية هي 5,000 استدعاء شهريا بمعدل 10 طلبات في الدقيقة مع سجل يومي لآخر 30 يوما. تفرض سقفا صلبا بدل فوترة الفائض، فلا يمكنها أن تبدأ الفوترة بصمت.

كيف يبدو مفتاح API الخاص بـexchangerate.dev؟

هو سلسلة نصية تبدأ بـexr_live_. ترسله كترويسة Authorization: Bearer، أو كـX-API-Key إذا تعذّر على أداتك ضبط ترويسات Authorization.

هل يمكنني استخدام المفتاح المجاني في منتج تجاري؟

تسمح المجانية بالاستخدام التجاري مع رابط إسناد ظاهر، والمدفوعة بلا إسناد. إعادة توزيع البيانات أو بيعها تحتاج اتفاقاً مكتوباً: hello@exchangerate.dev.

هل من الآمن وضع مفتاح API في الرابط؟

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

تابع القراءة

ابدأ بمفتاح API مجاني

5,000 طلب شهريًا ضمن الخطة المجانية. لا حاجة إلى بطاقة ائتمان.

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