Bir format. Dört bağlantı yolu.

CSV, XML ve JSON dosyalarında aynı alan adlarını kullanın. PostgreSQL için bu sütunları sağlayan salt okunur bir view oluşturabilirsiniz.

Zorunlu alanlar

AlanTürAçıklama
idMetinProjeniz içinde benzersiz ve kalıcı ürün kimliği.
nameMetinÜrün adı.
priceSayıSatış fiyatı. Ondalık ayracı nokta: 1299.90. Para sembolü eklemeyin.
currencyMetinÜç harfli para birimi: TRY, USD, EUR. Farklı para birimleri arasında dönüşüm yapılmaz.

İsteğe bağlı alanlar

descriptionÜrün açıklaması; öneri kalitesi için tavsiye edilir.
brand / categoryMarka ve kategori.
url / image_urlHTTPS ürün sayfası ve görsel adresi.
availabletrue / false. Belirtilmezse true. false ürünler önerilmez.
min_age / max_ageAlt ve üst yaş sınırı; boş bırakılabilir.
attributesEk özellikleri içeren JSON nesnesi. CSV’de JSON metni, XML’de alt etiketler.

JSON örneği

{
  "products": [
    {
      "id": "sku-001",
      "name": "Mimari Model Seti",
      "description": "Yetişkinler için 800 parçalı sergileme modeli.",
      "price": 1299.9,
      "currency": "TRY",
      "available": true,
      "brand": "Örnek Marka",
      "category": "Maket",
      "url": "https://example.com/products/sku-001",
      "image_url": "https://example.com/images/sku-001.jpg",
      "min_age": 18,
      "max_age": null,
      "attributes": {
        "pieces": 800,
        "color": "Krem"
      }
    }
  ]
}

Aktarım davranışı

Her dosya veya kaynak, projenin tam kataloğudur. Aynı ID güncellenir, yeni ID eklenir ve son aktarımda bulunmayan ürün kaldırılır. Fiyat değişiklikleri vektörün yeniden hesaplanmasını gerektirmez; açıklama ve ürün metni değişince ilgili vektör yenilenir. Hatalı bir satır varsa aktarım uygulanmaz; raporu düzeltip tekrar yükleyin.

Dosyalar UTF-8, en fazla 20 MB ve 50.000 ürün olmalı. URL kaynakları HTTPS olmalı; özel ağ adresleri kabul edilmez. PostgreSQL bağlantısında TLS doğrulaması ve yalnızca SELECT yetkisi kullanın. Sunucunuz dış bağlantıya açık değilse dosya veya HTTPS akışı tercih edin.

PostgreSQL view örneği

CREATE VIEW product_feed AS
SELECT sku::text AS id, title AS name,
       description, sale_price AS price, 'TRY' AS currency,
       is_active AS available
FROM products;

-- Bu view'a yalnızca SELECT yetkisi olan bir kullanıcı bağlayın.

Bu örneği kendi veritabanınızın alan adlarına uyarlayın. Selquivo kaynak veritabanında tablo veya view oluşturmaz.