Toplu Kod Yükle

Aynı teklif için toplu dijital kod yükler. Tek batch'te en fazla 10000 kod. Yüklenen kod sayısı kadar teklifin stoğu artar.

POST/v1/offers/{offerId}/digital-item-batchesscope:StockWrite

Yetkilendirme

Bu endpoint StockWrite 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).

Teklifin dijital ürün olması gerekir; fiziksel bir teklife kod yüklenemez, yanıt 422 olur.

İstek gövdesi

Alan	Tip	Zorunlu	Açıklama
`codes`	string[]	evet	Yüklenecek kodlar, 1–10000 adet; hiçbiri boş olamaz

{
  "codes": ["AAAA-BBBB-1111", "AAAA-BBBB-2222"]
}

Yinelenen değerler

Aynı teklifte zaten bulunan bir değer sessizce atlanır, istek reddedilmez. Kaç değerin gerçekten eklendiğini status söyler.

Yanıt

201 Created.

{
  "id": "019ff2bfad1e73d2930b14e0fb34974b",
  "offerId": "019e03697e257348a885252e731009f5",
  "totalCount": 2,
  "status": "Completed",
  "createdAt": "2026-08-11T21:34:35.8064466+00:00"
}

Alan	Tip	Açıklama
`id`	string	Parti kimliği — Dijital Kodları Listele ucunda `batchId` olarak kullanılır
`offerId`	string	Kodların eklendiği teklif
`totalCount`	number	Gönderdiğiniz değer sayısı
`status`	string	`Completed` (hepsi eklendi), `PartiallyCompleted` (bir kısmı yinelenen), `Failed` (hiçbiri eklenmedi), `Processing`
`createdAt`	datetime	ISO 8601, UTC

İ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`	`codes` boş, 10000'i aşıyor ya da boş eleman içeriyor
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`404`	Teklif bulunamadı veya size ait değil
`422`	Teklif dijital ürün değil
`429`	Hız limiti aşıldı