API - نظرة عامة

API - الملفات والخطوط والعملات

نزّل الملفات العامة والمحمية، واجلب قائمة الخطوط والعملات المتاحة.

نظرة عامة على نقاط النهاية

الطريقةنقطة النهايةالوصفالوصول
GET/public-api/v1/file/public/products/:productId/:sizeإعادة معاينة عامة للمنتج. يجب أن يكون الحجم small.png أو medium.png أو big.png.عام
GET/public-api/v1/file/protected/:keyإعادة ملف محمي باستخدام مفتاح التخزين.عنوان URL موقّع أو files:read
GET/public-api/v1/fontsإعادة جميع الخطوط المتاحة.عام
GET/public-api/v1/currenciesإعادة جميع العملات.عام

الملفات والخطوط والعملات

تلائم ملفات المعاينة العامة الاستخدام في المتصفح. تتطلب الملفات المحمية عنوان URL موقّعًا أو بيانات اعتماد API بصلاحية files:read. أما الخطوط والعملات فتوفرها نقاط نهاية عامة للقراءة.

نقطة النهايةالوصولالتفاصيل
/file/public/products/:productId/small.pngعاممعاينة صغيرة للمنتج.
/file/public/products/:productId/medium.pngعاممعاينة متوسطة للمنتج.
/file/public/products/:productId/big.pngعاممعاينة كبيرة للمنتج.
/file/protected/:keyعنوان URL موقّع أو files:readملف محمي في تخزين الكائنات.
/fontsعاممصفوفة سجلات الخطوط.
/currenciesعاممصفوفة سجلات العملات.

مثال طلب (fetch)

const publicPreview = await fetch(
  'https://alterproduct.com/public-api/v1/file/public/products/4/medium.png'
);

const protectedFile = await fetch(
  'https://alterproduct.com/public-api/v1/file/protected/user_34/381/design/mockup-large.webp',
  {
    headers: authHeaders
  }
);

const fonts = await fetch('https://alterproduct.com/public-api/v1/fonts').then((res) => res.json());
const currencies = await fetch('https://alterproduct.com/public-api/v1/currencies').then((res) => res.json());

مثال رد

[
  {
    "id": 1,
    "family": "Inter",
    "source": "google",
    "category": "sans-serif",
    "variants": ["regular", "600", "700"],
    "subsets": ["latin"],
    "version": "v19",
    "menu": "Inter",
    "files": {
      "regular": "https://..."
    }
  }
]
[
  {
    "id": 1,
    "code": "EUR",
    "name": "Euro",
    "symbol": "€",
    "decimalPlaces": 2
  }
]