Teklif Güncelle
Bir teklifin fiyatını ve satış ayarlarını günceller. İstek JSON Patch (RFC 6902) formatındadır.
PATCH
/v1/offers/{id}scope:OffersWriteYetkilendirme
Bu endpoint OffersWrite 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).
İstek gövdesi
Gövde bir işlem dizisidir; yalnızca değiştirmek istediğiniz alanları gönderirsiniz.
[
{ "op": "replace", "path": "/price", "value": 129.9 },
{ "op": "replace", "path": "/changeReason", "value": "Kampanya sonrası fiyat" }
]Güncellenebilir alanlar
| Path | Tip | Açıklama |
|---|---|---|
/price | decimal | 0'dan büyük olmalı |
/discountedPrice | decimal | 0'dan büyük olmalı |
/isActive | boolean | Teklifi yayına alır ya da yayından kaldırır |
/allowBackorder | boolean | Ön siparişi açar ya da kapatır |
/backorderLimit | number | Ön sipariş açıksa zorunlu |
/changeReason | string | En fazla 500 karakter; değişiklik kaydına yazılır |
Stok bu uçla değişmez
quantity güncellenebilir bir alan değildir. Dijital tekliflerde stok kod yükleyerek
(Toplu Kod Yükle) veya kod silerek değişir.
Yanıt
200 OK ile teklifin güncel hâli döner; gövde
Teklif Detayı ile aynı şekildedir.
Hata kodları
| Code | Anlam |
|---|---|
400 | Patch belgesi bozuk ya da değer sınırların dışında |
401 | HMAC kimlik doğrulama hatası |
403 | Gerekli scope eksik |
404 | Teklif bulunamadı veya size ait değil |
429 | Hız limiti aşıldı |