Besleme Endpointi

Ürün kataloğunu Selwise'e göndermek için push uç noktası. Besleme dosyası üretemiyorsanız ya da değişiklikleri anında yansıtmak istiyorsanız kullanılır. Panelde kurulum ve diğer yöntemler (adres, dosya yükleme) için Besleme Kurulumu sayfasına bakın.

Uç nokta

"<products><product><id>1</id>...</product></products>"

{
  "productCount": 18432,
  "rowsRead": 18500,
  "rowsSkipped": 68,
  "productsCreated": 120,
  "productsUpdated": 940,
  "productsUnchanged": 17372,
  "productsRemoved": 12,
  "skippedSamples": [
    {
      "itemCode": "SKU-9",
      "reason": "string"
    }
  ],
  "catalogSignals": {}
}

:token, panelde Product Feed ekranının API Access sekmesindeki API Token'dır. Bu uç site anahtarı istemez ve başka bir kimlik de aramaz: token tek başına bir feed'e yazma yetkisidir. Token bir feed'e aittir; önce bir adres kaydedin ya da bir dosya yükleyin, ondan sonra token oluşur. Regenerate Token eskisini iptal eder.

İstek

Gövde, besleme dosyanızın ham içeriğidir. Biçim bayttan algılanır, Content-Type ile bildirmeniz gerekmez; yani mevcut beslemenizi olduğu gibi gönderirsiniz.

Her Content-Type aynı yoldan okunur ve sınır her biri için 50 MB'tır: application/xml, text/xml, application/rss+xml, application/json, text/csv, text/plain ya da hiç başlık. XML, JSON, CSV ve TSV gövdeleri ilk baytlarından tanınır.

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

CSV için:

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

--data-binary kullanın; -d satır sonlarını siler. Gövde boşsa ya da okunamıyorsa 400 döner ve mesaj aldığı Content-Type'ı söyler.

Yanıt

İşlem eşzamanlıdır: istek besleme okunup yazılana kadar bekler ve sonucu döndürür.

Sayaçların anlamı yukarıdaki uç kutusundadır. rowsSkipped sıfır değilse katalog beslemenizden küçüktür; nedeni Çalışma Geçmişi sayfası anlatır.

Yanıtta ayrıca fiyat düşüşü ve stok yenilenmesi gibi senaryoların tükettiği bir catalogSignals nesnesi bulunur; entegrasyonunuzun okuması gerekmez.

Hatalar

Bir çalışma yarıda kalırsa ya da başarısız olursa hiçbir ürün silinmez: katalog bir önceki başarılı çalışmanın hâlinde kalır; feed durumu error olur ve mesaj panelde görünür.

Katalog baştan yazılır

Her gönderim katalogun tamamını temsil eder: göndermediğiniz ürünler, okuma sorunsuz tamamlandıysa katalogdan kalkar.

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: Alan Eşleştirme.

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.

Doğrulama

Gönderim sonrası Product Feed ekranında ürün sayısının ve son senkronizasyon zamanının güncellendiğini kontrol edin; gönderim Analytics sekmesinde "API push" etiketiyle bir çalışma olarak görünür. Hata varsa durum error olur ve mesaj görünür: Besleme Sorunları.