Besleme Endpointi

Ürün kataloğunu Selwise'e göndermek için push uç noktası. Besleme dosyası üretemiyorsanız veya değişiklikleri anında yansıtmak istiyorsanız kullanılır.

Uç nokta

POST /api/v1/public/feeds/:token

:token, panelde Product Feed sayfasında üretilen API token'ıdır.

Kurulum

1. Product Feed → Active method olarak API'yi seçin.
2. Üretilen token'ı kopyalayın.
3. Kendi sisteminizden kataloğu bu uç noktaya gönderin.

İstek

Gövde, besleme dosyanızın ham içeriğidir. Desteklenen içerik tipleri:

application/json
application/xml
text/xml
text/plain

Yani mevcut besleme dosyanızı olduğu gibi gövdede gönderirsiniz — ayrı bir biçime çevirmeniz gerekmez.

Örnek

curl -X POST "https://api.selwise.com/api/v1/public/feeds/TOKEN" \
  -H "Content-Type: application/xml" \
  --data-binary @katalog.xml

Alan eşleştirme

Push yönteminde de alan eşleştirmesi geçerlidir. Beslemenizdeki alan adları Selwise'in beklediğinden farklıysa panelden eşleyin — bkz. Alan Eşleştirme.

Katalog baştan yazılır

Her gönderimde katalog tamamen yenilenir. Gönderdiğiniz dosyada olmayan ürünler Selwise'ten kalkar.

Ne sıklıkla

Push yönteminin avantajı anlık güncellemedir, ama her fiyat değişikliğinde tüm kataloğu göndermek verimsizdir. Pratik yaklaşım:

Değişiklik	Yaklaşım
Fiyat/stok gün içinde sık değişiyor	Saatlik tam gönderim
Katalog nadiren değişiyor	Değişiklik olduğunda gönderim
Kampanya başlangıcı	Kampanya anında bir gönderim

Token güvenliği

Token, kataloğunuzu yazma yetkisi verir. Sunucu tarafında saklayın; tarayıcıya veya uygulama paketine koymayın.

Token sızdıysa panelden yenileyin; eski token geçersiz olur.

Doğrulama

Gönderim sonrası Product Feed sayfasında ürün sayısının ve son senkronizasyon zamanının güncellendiğini kontrol edin. Hata varsa durum error olur ve mesaj görünür — bkz. Besleme Sorunları.