أدلة التطوير باستخدام MetalAPI
كل ما تحتاجه لدمج أسعار المعادن والعملات والعملات المشفرة اللحظية والتاريخية — من طلبك الأول إلى خطافات الويب وأفضل الممارسات في بيئة الإنتاج.
البدء
طلبك الأول والمصادقة وكيفية عمل حدود الخطط.
البدء مع MetalAPI
أنشئ حسابًا مجانيًا واحصل على مفتاح API وأرسل طلبك الأول لمعرفة أسعار الذهب والفضة والبلاتين والبلاديوم اللحظية خلال دقائق معدودة، دون بطاقة ائتمان.
مصادقة API
أرسل مفتاح API كمعامل استعلام أو في ترويسة، وقيّد المفاتيح بنطاقات موقعك، واحفظها بأمان. دليل عملي لمصادقة طلبات MetalAPI مع أمثلة curl جاهزة.
حدود المعدل والخطط
كيف تعمل الحصص الشهرية وحدود الطلبات في الدقيقة وفترات تحديث الأسعار في كل خطة من خطط MetalAPI، وكيف تتابع استهلاكك عبر الترويسات دون إهدار حصتك الشهرية.
مرجع API
نقاط النهاية وصيغ الاستجابة والوحدات ورموز الأخطاء.
نقاط النهاية المتاحة
جميع نقاط نهاية MetalAPI ومعاملاتها: latest وhistorical وconvert وtimeframe وchange وOHLC وcarat وsymbols وusage وstream، مع أمثلة طلبات جاهزة لكل منها.
معالجة الأخطاء
رموز أخطاء MetalAPI ورموز حالة HTTP المقابلة لها، وكيفية معالجة الطلبات الفاشلة وإعادة محاولتها بأمان، مع أمثلة شيفرة جاهزة بلغة JavaScript.
صيغ البيانات والوحدات
كيف تُعرض الأسعار في MetalAPI، واختيار عملة الأساس ووحدة الكتلة، وأسعار الطلب والعرض وأسعار العيارات، والطوابع الزمنية وساعات تداول الأسواق.
نظرة عامة على توثيق API
جولة في صفحة واحدة على واجهة MetalAPI REST API: عنوان URL الأساسي والمصادقة والمعاملات وصيغة الاستجابة والأخطاء وحدود المعدل وأمثلة الشيفرة.
مواضيع متقدمة
التحليل التاريخي وخطافات الويب والودجات والتشغيل في بيئة الإنتاج.
ودجات الأسعار القابلة للتضمين
اعرض أسعار المعادن اللحظية على أي موقع ويب، من WordPress إلى Shopify، باستخدام ودجة قابلة للتضمين، دون شيفرة للواجهة الخلفية ودون مفتاح API في صفحتك.
خطافات الويب وتنبيهات الأسعار
تلقَّ استدعاءات HTTP موقّعة عندما يتجاوز السعر العتبة التي حددتها، وتحقّق من صحتها باستخدام HMAC-SHA256، مع أمثلة جاهزة بلغتي Node.js وPHP.
الوصول إلى البيانات التاريخية
استعلم عن الأسعار اليومية حتى عام 1999، واجلب نطاقات زمنية، وقارن بين تاريخين، واحصل على أشرطة OHLC، وحلّل اتجاهات أسعار المعادن مع MetalAPI.
أفضل الممارسات
خزّن الاستجابات مؤقتًا بذكاء، واطلب الرموز دفعةً واحدة، واستخدم البث بدلًا من الاستطلاع، وحافظ على أمان مفاتيحك وخطافات الويب في تكامل MetalAPI.
استخدام MetalAPI مع مساعدي الذكاء الاصطناعي (MCP)
اربط Claude وChatGPT وCursor وVS Code وغيرها من مساعدي الذكاء الاصطناعي بأسعار المعادن اللحظية عبر خادم MetalAPI MCP، بتسجيل الدخول أو بمفتاح API.