السعودية · الريال السعودي
ويدجت أسعار الذهب لموقعك
الويدجت مربع صغير تضعه في موقعك أو مدونتك، فيعرض لزوارك سعر جرام الذهب في السعودية بالريال ويتحدث من تلقاء نفسه كل 5 دقائق. ومن يريد الأرقام خاما ليعرضها بتصميمه يجدها في ملف JSON مفتوح على العنوان /api/prices.json.
ماذا يعرض الويدجت
يعرض سعر الجرام للعيارات 24 و22 و21 و18، ومعه وقت آخر تحديث بتوقيت الرياض. الأرقام هي أرقام صفحات أسعار الذهب نفسها: قيمة الذهب الخام محسوبة من السعر العالمي للأونصة، من غير مصنعية ولا ضريبة. طريقة الحساب مشروحة في صفحة كيف نحسب سعر الذهب.
كود التضمين
انسخ الكود التالي كما هو، ثم الصقه في صفحتك في الموضع الذي تريد أن يظهر فيه الويدجت.
<iframe src="https://aisear-aldhahab.com/widget/embed/?lang=ar" width="380" height="330" title="سعر الذهب اليوم في السعودية" loading="lazy" style="border:0"></iframe>بعد اللصق افتح صفحتك وتأكد أن وقت التحديث الظاهر في الويدجت يطابق الوقت المكتوب في الصفحة الرئيسية لأسعار الذهب.
ملف JSON المفتوح
عنوان الملف: /api/prices.json. يعاد توليده مع كل تحديث للأسعار، أي كل 5 دقائق، فلا فائدة من طلبه في مدد أقصر من ذلك. الأفضل أن يحفظ خادمك نسخة منه ويعرض منها إلى أن يحين التحديث التالي.
| الحقل | معناه | مثال |
|---|---|---|
ts | وقت التحديث بصيغة Unix | 1794384000 |
updated | وقت التحديث بتوقيت الرياض | 14:35 |
usd_sar | سعر صرف الدولار بالريال المستخدم في الحساب | 3.75 |
spot.usd_oz | سعر الأونصة بالدولار | 4058.30 |
spot.prev_close | إغلاق الأونصة أمس بالدولار | 4039.90 |
spot.open / spot.high / spot.low | افتتاح الأونصة وأعلى وأدنى سعر اليوم بالدولار | 4041.00 |
gram.24k.buy | جرام عيار 24 للشراء بالريال | 489.29 |
gram.24k.sell | جرام عيار 24 للبيع (تقدير) بالريال | 479.50 |
gram.24k.prev | جرام عيار 24 عند إغلاق أمس | 487.07 |
gram.22k / gram.21k / gram.18k | الحقول نفسها لعيار 22 و21 و18 | … |
spread_pct | الفرق بين الشراء والبيع بالنسبة المئوية | 2.0 |
used_discount_pct | خصم الذهب المستعمل بالنسبة المئوية | 3.0 |
vat_pct | ضريبة القيمة المضافة | 15 |
market_open | هل السوق العالمية مفتوحة | true |
الأسعار في الملف بالريال السعودي، ووقت التحديث فيه بتوقيت الرياض.
شروط الاستخدام
الأرقام حساب تقديري من السعر العالمي وليست تسعيرة محل، فإن عرضتها لزوارك فانقل لهم هذا التوضيح معها.
أسئلة عن الويدجت والبيانات
كل كم تتحدث أسعار الويدجت؟
كل 5 دقائق، مع تحديث أسعار الموقع نفسه. في نهاية الأسبوع تكون السوق العالمية مغلقة، فيبقى آخر سعر ظاهرا حتى تفتح.
هل أرقام الويدجت تشمل المصنعية والضريبة؟
لا. هي قيمة الذهب الخام في الجرام. المصنعية تختلف من قطعة إلى أخرى فلا يمكن وضعها في رقم واحد، وضريبة القيمة المضافة يحسبها المحل على الذهب والمصنعية معا.