Teklif Oluştur
Bir katalog varyantı için teklif açar.
POST
/v1/offersscope:OffersWriteYetkilendirme
Bu endpoint OffersWrite scope'u gerektirir. Bkz. İzinler.
İstek gövdesi
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
variantId | string(32) | evet | Teklifin açılacağı katalog varyantı |
productType | string | evet | Physical ya da Digital |
price | decimal | evet | 0'dan büyük, en fazla 2 ondalık |
discountedPrice | decimal | hayır | price değerinden küçük olmalı |
currency | string(3) | evet | ISO kodu, ör. TRY |
quantity | number | evet | Başlangıç stoğu |
isActive | boolean | hayır | Teklifin yayında olup olmayacağı |
allowBackorder | boolean | hayır | Stok bittiğinde sipariş almaya devam et |
backorderLimit | number | allowBackorder ise | Ön sipariş üst sınırı |
{
"variantId": "019e969e56427642a873b18fcd112df6",
"productType": "Digital",
"price": 49.9,
"currency": "TRY",
"quantity": 0,
"isActive": false,
"allowBackorder": false
}Dijital tekliflerde stok
Kod yükleme bu uçla yapılmaz. Dijital bir teklifi quantity: 0 ile açıp kodları
Toplu Kod Yükle ucuyla eklersiniz; stok yüklenen
kod adedi kadar artar.
Yanıt
201 Created. Gövde Teklif Detayı ile aynı şekildedir.
İdempotency
Idempotency-Key header'ı opsiyoneldir ama önerilir. Aynı key ile gelen sonraki başarılı istek cached response döner. Detay: Idempotency.
Hata kodları
| Code | Anlam |
|---|---|
400 | Zorunlu alan eksik ya da değer sınırların dışında |
401 | HMAC kimlik doğrulama hatası |
403 | Gerekli scope eksik |
404 | Varyant bulunamadı |
409 | Bu varyant için zaten bir teklifiniz var |
429 | Hız limiti aşıldı |