## نظرة عامة يعيد الكتالوج الكامل لبطاقات الهدايا والمنتجات الرقمية المنظَّمة حسب الفئات (الألعاب، البث، إلخ). **احتفظ بهذه البيانات في cache** لمدة 24 ساعة على الأقل. يتغير الكتالوج نادراً. ## الاستجابة حالة الطلب إجمالي عدد الفئات في الكتالوج إجمالي عدد المنتجات عبر جميع الفئات مصفوفة كائنات الفئات مع المنتجات اسم الفئة (مثال: "PSN"، "Game Stores"، "iTunes") مصفوفة كائنات المنتجات معرف المنتج الفريد (للاستخدام مع `/check-product`) اسم عرض المنتج متاح عبر API كود المنطقة الجغرافية (مثال: "germany"، "united-states-america") طابع زمني للاستجابة بتنسيق ISO 8601 ## أمثلة ```bash cURL theme={null} curl https://api.oneclickdz.com/v3/gift-cards/catalog \ -H "X-Access-Token: YOUR_API_KEY" ``` ```javascript Node.js theme={null} const response = await fetch( "https://api.oneclickdz.com/v3/gift-cards/catalog", { headers: { "X-Access-Token": "YOUR_API_KEY" }, } ); const { data } = await response.json(); // Filter enabled products const enabledProducts = data.categories.flatMap((cat) => cat.products.filter((p) => p.enabled) ); ``` ```python Python theme={null} response = requests.get( 'https://api.oneclickdz.com/v3/gift-cards/catalog', headers={'X-Access-Token': 'YOUR_API_KEY'} ) catalog = response.json()['data'] # Filter by category gaming = next(c for c in catalog['categories'] if c['name'] == 'Gaming Cards') ``` ```php PHP theme={null} ``` ### مثال الاستجابة ```json theme={null} { "success": true, "totalCategories": 14, "totalProducts": 62, "data": { "categories": [ { "title": "PSN", "products": [ { "id": "6126393c6f57860f925a1983", "title": "PSN Germany", "enabled": true, "region": "germany" }, { "id": "612619816f57860f9259eee3", "title": "PSN UK", "enabled": true, "region": "united-kingdom" } ] } ] }, "meta": { "timestamp": "2025-10-29T00:36:52.615Z" } } ``` ## بناء واجهة عرض المنتجات ```javascript theme={null} // Example: Building a category-based UI function renderCatalog(catalog) { return catalog.categories.map((category) => ({ categoryName: category.name, products: category.products .filter((p) => p.enabled) .map((p) => ({ id: p.id, name: p.title, imageUrl: `/images/products/${p.id}.png`, })), })); } ``` ## استراتيجية التخزين المؤقت ```javascript Node.js theme={null} // Cache for 24 hours const cache = { data: null, timestamp: 0, ttl: 24 * 60 * 60 * 1000, // 24 hours }; async function getCatalog() { const now = Date.now(); if (cache.data && now - cache.timestamp < cache.ttl) { return cache.data; } const response = await fetch( "https://api.oneclickdz.com/v3/gift-cards/catalog", { headers: { "X-Access-Token": process.env.API_KEY }, } ); cache.data = await response.json(); cache.timestamp = now; return cache.data; } ``` ```python Python theme={null} from datetime import datetime, timedelta import requests class CatalogCache: def __init__(self): self.data = None self.timestamp = None self.ttl = timedelta(minutes=10) def get(self): if self.data and datetime.now() - self.timestamp < self.ttl: return self.data response = requests.get( 'https://api.oneclickdz.com/v3/gift-cards/catalog', headers={'X-Access-Token': 'YOUR_API_KEY'} ) self.data = response.json() self.timestamp = datetime.now() return self.data catalog_cache = CatalogCache() ``` ## أفضل الممارسات خزّن لمدة 10 دقائق أو أكثر لتقليل استدعاءات API أظهر فقط المنتجات حيث `enabled: true` فلترة حسب المنطقة إذا كنت تستهدف أسواقاً محددة استخدم الفئات لتجربة مستخدم أفضل ## الخطوات التالية بعد الحصول على الكتالوج: أظهر المنتجات للمستخدمين منظمةً حسب الفئة استخدم `/checkProduct/:id` للحصول على الأسعار والمخزون استخدم `/placeOrder` لشراء المنتج المحدد ## ذات صلة الحصول على الأسعار والمخزون شراء المنتج