منهجية التسعير، مصادر الـ API المجانية الحية، والتوافق مع Cloudflare
تعمل منصة «مِعيَار الذهب» بمحرك جلب بيانات متعدد الطبقات (Multi-Tier Live Waterfall Engine) مصمم خصيصاً ليعمل مجاناً وبكفاءة كاملة على بيئة Cloudflare Pages / Workers دون الحاجة إلى كشط صفحات HTML (Web Scraping) القابلة للحظر.
1. قائمة مصادر الـ API الحية والمجانية المدمجة في الموقع
يقوم الكود في lib/gold-provider.ts بالاتصال التلقائي المتدرج (Failover Waterfall) بالمصادر التالية بالترتيب لضمان عدم توقف الموقع أبداً:
| الطبقة / المصدر | الرابط البرمجي (Endpoint) | البيانات والتحديث | التكلفة والمفتاح |
|---|---|---|---|
| 1. Gold-API (أساسي حي) | api.gold-api.com/price/XAU | سعر أونصة الذهب الفوري بالدولار (XAU/USD) محدث لحظياً | مجاني 100% — بدون مفتاح |
| 2. ExchangeRate-API v6 | open.er-api.com/v6/latest/USD | سعر صرف الدولار مقابل الجنيه المصري (USD/EGP) | مجاني 100% — بدون مفتاح (بشرط الإسناد) |
| 3. ExchangeRate-API v4 (احتياطي) | api.exchangerate-api.com/v4/latest/USD | مزود احتياطي فوري لسعر صرف الجنيه المصري | مجاني 100% — بدون مفتاح |
| 4. Cloudflare Currency-API | latest.currency-api.pages.dev/.../xau.min.json | أسعار XAU/USD وXAU/EGP مستضافة مباشرة على شبكة Cloudflare Pages | مجاني ومفتوح (CC0) بلا حدود |
| 5. jsDelivr Currency CDN | cdn.jsdelivr.net/npm/@fawazahmed0/currency-api | الأرشيف التاريخي اليومي (7 و30 و90 يوماً) + بديل عالمي | مجاني ومفتوح (CC0) بلا حدود |
| 6. GoldAPI.io (اختياري) | www.goldapi.io/api/XAU/USD | يعمل تلقائياً إذا أضفت مفتاح GOLDAPI_IO_KEY في Cloudflare | باقة مجانية (100 طلب/شهر) |
2. لماذا نستخدم واجهات JSON APIs الرسمية بدلاً من الـ Web Scraping؟
يتساءل الكثير من المطورين عن إمكانية سحب الأسعار عبر كشط صفحات المواقع المنافسة (Web Scraping)؛ ولكن عند الاستضافة على Cloudflare تحديداً، فإن الـ Web Scraping يسبب المشكلات الجوهرية التالية:
- حظر عناوين IP الخاصة بـ Cloudflare Workers (`HTTP 403 Forbidden`): معظم مواقع الذهب المحلية محمية بجدار ناري (WAF / Bot Fight Mode) يحظر تلقائياً أي طلبات كشط قادمة من مراكز بيانات السحابة.
- انكسار الموقع عند أي تعديل في HTML: تغيير اسم كلاس واحد في الموقع المكشوط يؤدي إلى ظهور أسعار صفرية أو خاطئة للمستخدمين.
- مخاطر السيو وحقوق الملكية: الاعتماد على كشط محتوى المنافسين يعرض الموقع لعقوبات الجودة في محركات البحث.
- الحل الهندسي المعتمد في منصتنا: الجمع بين السعر الفوري العالمي الموثق (
XAU/USD) وسعر الصرف الرسمي (USD/EGP) عبر واجهات JSON سريعة ومجانية، مع معامل معايرة لسوق الصاغة المصري (SAGHA_BUY_PREMIUM_PERCENTوSAGHA_SELLBACK_SPREAD_PERCENT) يمكنك تعديله في أي لحظة من لوحة تحكم Cloudflare دون إعادة برمجة الكود!
3. المعادلة الرياضية المعتمدة
خطوات الحساب القياسية:
1. وزن الأونصة الترويسية القياسي = 31.1034768 جرام (عيار 24 نقاء 999.9)
2. سعر جرام عيار 24 العالمي المكافئ (ج.م) = (سعر الأونصة XAU/USD × سعر الصرف USD/EGP) ÷ 31.1034768
3. سعر جرام عيار (K) = سعر جرام عيار 24 × (K ÷ 24)
4. وزن الجنيه الذهب القياسي = 8 جرامات من عيار 21 (نقاء 875)
4. جاهزية الرفع على Cloudflare (Cloudflare Pages / Workers)
تم إعداد المشروع بملفي wrangler.jsonc وpublic/_headers لضبط التخزين المؤقت على حافة الشبكة (Edge Caching s-maxage=180, stale-while-revalidate=300) بحيث تُخدم آلاف الزيارات في مصر من أقرب مركز بيانات لـ Cloudflare بسرعة فائقة وضمن الباقة المجانية تماماً.