Interface PlayerStore

Oyuncu mağaza yüzeyi (PlayerClient.store).

interface PlayerStore {
    buy(
        listingId: string,
        options: StoreBuyOptions,
    ): Promise<StoreBuyResult>;
    catalog(options?: StoreCatalogOptions): Promise<StoreCatalog>;
}

Index

Methods

Methods

buy

buy(listingId: string, options: StoreBuyOptions): Promise<StoreBuyResult>
Oyuncunun kendi oturumuyla ürün satın alır (POST /v1/player/store/listings/{id}/buy).

Kullanım: expectedVersion olarak oyuncunun gördüğü StoreListing.version verilir. Anahtar verilmezse SDK üretir; ağ kopması sonrası kullanıcı yeniden denerken AYNI idempotencyKey verilmelidir (ikinci tahsilat olmaz, replayed: true döner).

Hatalar
- CrxError(Contract) — geçersiz girdi (ağa çıkılmaz) ya da beklenmeyen yanıt
- CrxError(Http) — storeBuyErrorCode(error) ile ayrışan retler: not_visible 404, listing_changed 409, out_of_stock / limit_reached / insufficient_funds / inventory_full 422; diğer kodlar genel kalır
Parameters
- listingId: string
- options: StoreBuyOptions
Returns Promise<StoreBuyResult>

catalog

catalog(options?: StoreCatalogOptions): Promise<StoreCatalog>
Oyuncunun görebildiği vitrinleri okur (GET /v1/store/pages[?page=]).

Hatalar
- CrxError(Contract) — yanıt biçimi beklenenden farklı ya da page geçersiz (ağa çıkılmaz)
- CrxError(Auth|Http|Network|Timeout|Cancelled) — oturum yok (401), vitrin yok (404) ve taşıma hataları
Parameters
- Optionaloptions: StoreCatalogOptions
Returns Promise<StoreCatalog>