إجابتان صادقتان، الأقصر أولا. لتجربة الواجهة البرمجية لا تحتاج مفتاحا: كل نقطة نهاية بيانات؛ /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. - لا تضع المفتاح أبدا في رابط أو حزمة متصفح عامة, الترويسات فقط، بوساطة خادم للواجهات الأمامية.
مسار دون مفتاح: جرّب الواجهة البرمجية أولا
قبل إنشاء أي شيء، استدعِ الواجهة البرمجية وانظر إلى حمولة حقيقية. يعمل هذا من أي طرفية دون تسجيل:
# 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 (بعض أدوات ذكاء الأعمال ومنصات بلا كود):
# 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.