Teklif Görseli Yükle

Var olan bir teklife satıcı görseli ekler. Görsel Pending durumunda kaydedilir ve moderasyondan geçtikten sonra mağaza sayfanızda görünür.

Yetkilendirme

Bu endpoint OffersWrite scope'u gerektirir. Bkz. İzinler.

İstek

multipart/form-data ile gönderilir. Her istek tek bir görsel yükler; birden fazla görsel için isteği tekrarlayın.

Görselin hangi ürüne ait olduğu yoldaki teklifden okunur; ayrıca variant bilgisi göndermeniz gerekmez.

Dosyanın içeriği de görsel olarak doğrulanır; Content-Type alanını değiştirmek ya da uzantıyı .jpg yapmak yeterli değildir.

Kapak görseli

Bir teklifin ilk görseli kapak olarak işaretlenir. Kapak seçimi API üzerinden değiştirilemez; sıralamayı displayOrder ile yönetebilirsiniz.

Sınırlar

Bir teklifte en fazla 8 görsel bulunabilir. Sınır dolduğunda yeni yükleme 409 Conflict ile reddedilir; yer açmak için Teklif Görseli Sil ucunu kullanın.

Yanıt

201 Created ile oluşan kayıt döner. Alan açıklamaları için Teklif Görselleri sayfasına bakın.

{
  "id": "019ff2645beb70f1b010d93780ae1979",
  "displayOrder": 0,
  "isCover": true,
  "status": "Pending",
  "rejectionReason": null
}

Yükleme sonrası onay durumunu Teklif Görselleri ucundan takip edin. Reddedilen görsellerin gerekçesi rejectionReason alanında döner.

Path parametresi

Yalnızca kendi kaynaklarınızı görebilirsiniz. Başka satıcıya ait bir ID için yanıt 404 Not Found olur (403 değil — resource existence leak'i önlemek için).

Görsel yüklemek için o üründe teklifinizin bulunması gerekir. Teklifi olmayan bir ürüne görsel yüklenemez; yanıt 404 olur.

İdempotency

Idempotency-Key header'ı opsiyoneldir ama önerilir. Aynı key ile gelen sonraki başarılı istek cached response döner. Detay: Idempotency.

Hata kodları