## نظرة عامة يعيد أنواع/فئات المنتج مع الأسعار في الوقت الفعلي وتوافر المخزون. الأسعار مخصصة لحسابك. **احذف `cost` قبل عرضه للمستخدمين.** ## معاملات المسار معرف المنتج من endpoint الـ `/catalog` ## الاستجابة مصفوفة كائنات نوع/فئة المنتج معرف النوع (للاستخدام عند تقديم الطلبات) اسم النوع/الفئة (مثال: "100 DA"، "1000 DA") سعرك (يشمل الخصم) المخزون المتاح (0 = نفد من المخزون) ## أمثلة ```bash cURL theme={null} curl https://api.oneclickdz.com/v3/gift-cards/checkProduct/507f1f77bcf86cd799439011 \ -H "X-Access-Token: YOUR_API_KEY" ``` ```javascript Node.js theme={null} const productId = "507f1f77bcf86cd799439011"; const response = await fetch( `https://api.oneclickdz.com/v3/gift-cards/checkProduct/${productId}`, { headers: { "X-Access-Token": "YOUR_API_KEY" } } ); const { data } = await response.json(); // Filter in-stock items const available = data.types.filter((t) => t.quantity > 0); ``` ```python Python theme={null} product_id = '507f1f77bcf86cd799439011' response = requests.get( f'https://api.oneclickdz.com/v3/gift-cards/checkProduct/{product_id}', headers={'X-Access-Token': 'YOUR_API_KEY'} ) types = response.json()['data']['types'] # Filter available available = [t for t in types if t['quantity'] > 0] ``` ```php PHP theme={null} 0; }); ?> ``` ### مثال الاستجابة ```json theme={null} { "success": true, "data": { "productId": "507f1f77bcf86cd799439011", "productTitle": "PlayStation Network", "types": [ { "id": "type_001", "name": "PSN 500 DA", "price": 490, "quantity": 150 }, { "id": "type_002", "name": "PSN 1000 DA", "price": 980, "quantity": 87 }, { "id": "type_003", "name": "PSN 2000 DA", "price": 1960, "quantity": 0 } ] }, "meta": { "timestamp": "2025-10-29T01:00:00.000Z" } } ``` ## تطبيق هامش الربح ```javascript theme={null} function applyMarkup(types, markupPercent = 5) { return types .filter((t) => t.quantity > 0) .map((t) => ({ id: t.id, name: t.name, price: Math.ceil(t.price * (1 + markupPercent / 100)), available: true, })); } // Usage const customerPrices = applyMarkup(data.types, 5); // 5% markup ``` ## أفضل الممارسات تأكد من `quantity > 0` قبل العرض أضف هامش ربحك إلى `price` لا تُظهر أبداً `price` الجملة للعملاء قم بتحديث المخزون بشكل دوري ## روابط ذات صلة تصفح جميع المنتجات شراء منتج