أسعار الصرف في Next.js وTypeScript
اجلب أسعار الصرف من Server Component، وأبق مفتاح API على الخادم، وخزّن الاستجابة دون فقد وقت تحديث البيانات.
استدع exchangerate.dev من Server Component أو Route Handler. يستطيع Next.js إعادة التحقق كل 60 ثانية، بينما تشرح source وmarket_session وdata_updated_at معنى السعر المخزن.
Key points
احتفظ بـ
EXCHANGERATE_API_KEY على الخادم فقط، من دون NEXT_PUBLIC_.استخدم
next: { revalidate: 60 } لتقليل الطلبات المتكررة.اعرض
data_updated_at بدل اعتبار timestamp وقت رصد السوق.استخدم السعر الاسترشادي للعرض، واترك التسوية لمزود الدفع.
اجلب البيانات من الخادم
يعمل Server Component خارج المتصفح ويمكنه قراءة متغير خاص. يطلب المثال EUR وGBP مقابل USD ويتحقق من حالة HTTP.
خزّن الطلب واحتفظ بوقت الرصد
يحد next: { revalidate: 60 } مدة التخزين إلى 60 ثانية، لكنه لا يحول السعر المرجعي اليومي إلى سعر لحظي. احتفظ بـsource وmarket_session وdata_updated_at.
لا تكشف المفتاح
قد تدخل متغيرات
NEXT_PUBLIC_ إلى حزمة المتصفح. اقرأ EXCHANGERATE_API_KEY في الخادم فقط.افصل عملة العرض عن التسوية
يمكن للمتجر عرض سعر محلي تقريبي. يجب أن يأتي المبلغ النهائي من مزود الدفع لأنه يشمل الرسوم والفارق ووقت التسوية.
- أبق المفتاح على الخادم.
- خزّن الاستجابات الناجحة فقط.
- اعرض المصدر ووقت الرصد.
- احتفظ بالسعر والعملة الأصليين للتسوية.
MM
exchangerate.dev
أدلة تكامل للمطورين العاملين مع بيانات العملات.