توثيق API
وصول برمجي مباشر لأسعار الذهب والفضة والأسهم والعملات — مصري، سعودي، وعالمي.
المصادقة
كل طلب لازم يحتوي هيدر X-Api-Key بمفتاحك الخاص،
وتقدر تولّده من لوحتك بعد تفعيل حسابك.
curl https://api.example.com/market/api/gold \
-H "X-Api-Key: YOUR_API_KEY" Endpoints الأسعار
كل فئة ليها endpoint مستقل، وكل واحد محتاج صلاحية (scope) موجودة في اشتراكك:
GET /market/api/gold — الذهب
معامل اختياري: ?source=egypt|saudi|global
GET /market/api/silver — الفضة
معامل اختياري: ?source=egypt|saudi|global
GET /market/api/stocks — الأسهم
معامل اختياري: ?source=egypt|saudi|global
GET /market/api/crypto — العملات الرقمية
معامل اختياري: ?source=egypt|saudi|global
GET /market/api/oil — النفط
معامل اختياري: ?source=egypt|saudi|global
GET /market/api/fx — العملات
معامل اختياري: ?source=egypt|saudi|global
تاريخ السعر
GET /market/api/gold/history?source=egypt&key=gram_21&days=30 الأخطاء والحدود
| الكود | المعنى |
|---|---|
| 401 | مفتاح API غير صحيح |
| 402 | الاشتراك منتهي |
| 403 | الفئة غير متاحة في خطتك |
| 429 | تجاوزت الحصة الشهرية المسموحة |