Dijital Kodları Listele
Teklife ait dijital kodları sayfa sayfa listeler. Kod değerleri maskelenir.
/v1/offers/{offerId}/digital-itemsscope:StockReadYetkilendirme
Bu endpoint StockRead 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).
Query parametreleri
Sayfalama zorunlu — page, pageSize, orderBy, order alanları gerekir. Detay için
Sayfalama sayfasına bakın.
| Parametre | Tip | Açıklama |
|---|---|---|
status | string | Available, Reserved, Sold, Expired, Invalid, Refunded, Compromised |
batchId | string(32) | Tek bir yükleme partisinin kodları |
orderBy şu alanlardan biri olabilir: CreatedAt, ExpiresAt, Status, ValueType.
Yanıt formatı
200 OK ile birlikte pagination header'ları (X-Total-Count, X-Page, X-Page-Size,
X-Next-Page, X-Prev-Page) döner. Body sadece kayıt dizisini içerir.
[
{
"id": "019e20eb016f713380ddd220b18db618",
"offerId": "019e03697e257348a885252e731009f5",
"batchId": "019e20eb015a7e6c8e1390e6baffa8a5",
"maskedValue": "988****231",
"valueType": "Code",
"status": "Sold",
"expiresAt": null,
"createdAt": "2026-05-13T10:38:52.783657+00:00"
}
]Alanlar
| Alan | Tip | Açıklama |
|---|---|---|
id | string | Kod kimliği — silmek için bu kullanılır |
offerId | string | Kodun ait olduğu teklif |
batchId | string | Toplu yükleme ile eklendiyse partinin kimliği; tekil eklemelerde boştur |
maskedValue | string | Kodun maskelenmiş hâli |
valueType | string | Code, Key, Link, Credential, File |
status | string | Kodun durumu; yalnızca Available olanlar satışa hazırdır |
expiresAt | datetime | Kodun geçerlilik sonu, ISO 8601, UTC |
createdAt | datetime | Kodun eklendiği an, ISO 8601, UTC |
Kod değeri açık dönmez
Bu uç kodun kendisini hiçbir durumda döndürmez; maskedValue ilk üç ve son üç karakteri
gösterir, arasını yıldızlar. Altı karakter ve daha kısa değerlerde maskelenecek bir orta
kalmadığı için değer olduğu gibi görünür.
Hata kodları
| Code | Anlam |
|---|---|
400 | Sayfalama veya filtre değeri geçersiz |
401 | HMAC kimlik doğrulama hatası |
403 | Gerekli scope eksik |
404 | Teklif bulunamadı veya size ait değil |
429 | Hız limiti aşıldı |