Teklif Görselleri

Teklife yüklediğiniz satıcı görsellerinin listesini ve her birinin onay durumunu döner.

GET/v1/offers/{offerId}/imagesscope:OffersRead

Yetkilendirme

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

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).

Yanıt formatı

200 OK ile displayOrder değerine göre artan sıralı bir dizi döner. Bu uç sayfalanmaz; bir teklifte en fazla 8 görsel bulunabildiği için liste tek istekte tamamını verir.

[
  {
    "id": "019ff2645beb70f1b010d93780ae1979",
    "displayOrder": 0,
    "isCover": true,
    "status": "Approved",
    "rejectionReason": null
  },
  {
    "id": "019ff26a1c4472b3990ac1e5f2b8d011",
    "displayOrder": 1,
    "isCover": false,
    "status": "Rejected",
    "rejectionReason": "Görselde filigran var"
  }
]

Alanlar

Alan	Tip	Açıklama
`id`	string	Görselin kimliği; silme işleminde bu değer kullanılır
`displayOrder`	number	Görselin sırası; küçük değer önce gösterilir
`isCover`	boolean	Teklifin kapak görseli mi
`status`	string	Onay durumu: `Pending`, `Approved`, `Rejected`
`rejectionReason`	string \| null	Yalnızca `Rejected` durumunda dolu olur

Onay durumları

Durum	Anlam
`Pending`	Yükleme alındı, moderasyon bekliyor
`Approved`	Onaylandı; görsel mağaza sayfanızda gösterilir
`Rejected`	Reddedildi; gerekçe `rejectionReason` alanındadır

Hata kodları

Code	Anlam
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`404`	Teklif bulunamadı veya size ait değil
`429`	Hız limiti aşıldı