Ürün Hizmetleri (Product Services)
Ürün kataloğunuzu programatik olarak yönetin. Videolarınızda kullanmak üzere ürün bilgilerini oluşturun, güncelleyin ve alın.
/products
Hesabınızdaki tüm ürünlerin bir listesini alın.
{
"data": [
{
"id": "prod_123456789",
"name": "Kablosuz Kulaklık",
"description": "Premium gürültü önleyici kulaklık",
"image_url": "https://example.com/image1.jpg",
"created_at": "2023-11-23T10:00:00Z"
}
],
"has_more": false
}/products
Kataloğunuzda yeni bir ürün oluşturun. Ürün görseli yüklerken AI destekli dekupe özelliğini kullanabilirsiniz.
İstek Gövdesi (Request Body)
| Alan | Tür | Açıklama |
|---|---|---|
| name | string | Ürünün adı. Gerekli. |
| description | string | Ürünün ayrıntılı açıklaması. Opsiyonel. |
| image_url | string | Ürün görselinin URL'si. Gerekli. Maksimum 5MB boyutunda olmalıdır. |
| dekupe | boolean | AI ile otomatik dekupe işlemi. Varsayılan: true. Aktif olduğunda görsel arka planı temizlenir ve profesyonel bir görsel oluşturulur. Sonucu önizleyebilir ve 3 kereye kadar yeniden deneyebilirsiniz. |
💡 Dekupe İşlemi Nasıl Çalışır?
dekupe: true olduğunda, yüklenen görsel AI (Nano Banana Pro) ile işlenir. Arka plan temizlenir, gereksiz detaylar kaldırılır ve maksimum 1024px boyutunda optimize edilmiş bir görsel oluşturulur. İşlem genellikle 10-30 saniye sürer. Sonucu beğenmezseniz, 3 kereye kadar yeniden deneyebilirsiniz.
/products/:id
Belirli bir ürünün ayrıntılarını ID'sine göre alın.
/products/:id
Mevcut bir ürünü güncelleyin. Yalnızca güncellemek istediğiniz alanları sağlamanız gerekir.
/products/:id
Bir ürünü kataloğunuzdan silin. Bu işlem geri alınamaz.
Ürün Limitleri ve Kısıtlamalar
Ürün Sayısı Limiti
Her kullanıcı hesabı için maksimum 5 ürün yüklenebilir. Bu limit aşıldığında yeni ürün oluşturulamaz.
Hata Yanıtı (403 Forbidden)
{
"error": "Product limit reached",
"message": "Maximum 5 products allowed per user",
"current_count": 5,
"max_allowed": 5
}Dosya Boyutu Limiti
Ürün görselleri maksimum 5MB boyutunda olmalıdır. Desteklenen formatlar: JPG, PNG, WebP.
Hata Yanıtı (413 Payload Too Large)
{
"error": "File too large",
"message": "Maximum file size is 5MB",
"max_size": 5242880
}Limit Kontrolü Örneği
Yeni ürün oluşturmadan önce mevcut ürün sayısını kontrol edin:
// Mevcut ürünleri kontrol et
const response = await fetch('/api/live/products', {
headers: {
'Authorization': 'Bearer YOUR_TOKEN'
}
});
const { data: products } = await response.json();
if (products.length >= 5) {
console.error('Ürün limiti aşıldı. Maksimum 5 ürün yüklenebilir.');
return;
}
// Yeni ürün oluştur
// ...