وثائق الـ API

GET /api/v1/health

فحص صحة الخدمة.

GET /api/v1/summary

استجابة مُجمّعة لأسعار الصرف والذهب والفضة والعملات الرقمية — النقطة الأنسب لواجهة الجوال.

GET /api/v1/rates

أحدث أسعار الصرف مع نسبة التغير عن آخر قراءة.

{
  "success": true,
  "generated": "...",
  "data": {
    "base": "SYP",
    "currencies": [ { "code":"USD", "buy":..., "sell":..., "change_pct":..., "fetched_at":"..." } ]
  }
}

GET /api/v1/rates/{code}

آخر سعر لعملة واحدة (مثل USD).

GET /api/v1/rates/{code}/history?limit=168

التاريخ (حد أقصى 720 نقطة). النقاط ترجع مرتّبة من الأقدم للأحدث.

GET /api/v1/gold, /api/v1/gold/history?karat=24K&limit=168

أسعار الذهب لجميع العيارات، وتاريخ عيار محدد.

GET /api/v1/silver, /api/v1/silver/history?unit=ounce

GET /api/v1/crypto

GET /api/v1/convert?from=USD&to=SYP&amount=100

محوّل العملات (يتم التحويل عبر الليرة السورية كوسيط).