Ana içeriğe atla
Aşağıdaki örneklerde https://siteniz.com yerine kendi sitenizi, API_ANAHTARINIZ yerine Ayarlar → API sayfasındaki anahtarı kullanın.
Bu örnekler sunucu tarafında çalışmalıdır (oyun sunucusu, bot sunucusu, kendi backend’iniz). API anahtarını asla tarayıcıya veya oyunculara ulaşan bir yere koymayın.

İstemci kurulumu

Kullanıcı ve bakiye

GET /users yanıtı şifre hariç hesap bilgilerini ve linkedAccounts nesnesini (ör. { "discord": "1234…" }) içerir.

Kredi işlemleri

Örneğin bir oy verme ödülü, etkinlik ödülü veya Discord seviye sistemi için /credits/add kullanabilirsiniz. Ekleme ve çıkarma işlemleri oyuncunun kredi geçmişine yazılır; /credits/set yazılmaz.

Kredi ile ürün satın alma

Ürünler form dizisi olarak gönderilir:
Satın alma sitedeki kurallarla aynı çalışır: indirimler, abonelik yükseltme, zorunlu ürünler, zorunlu bağlı hesaplar, vergi, stok ve cashback uygulanır; komutlar ve roller teslim edilir. Olası hatalar: INSUFFICIENT_BALANCE, OUT_OF_STOCK, REQUIRED_PRODUCT, REQUIRED_LINKED_ACCOUNT, DOWNGRADE_NOT_ALLOWED, INVALID_VARIABLE. Oyun içi mağaza menüsü için GET /store/listing?username=Steve oyuncuya özel kategori ağacını, nihai fiyatları ve yükseltme bilgisini verir.

Roller

Destek talepleri

Talep açıldığında Discord webhook bildirimi (ayarlıysa) gönderilir.

Discord botu

Discord ID ile kullanıcıyı ve rollerini alıp, discordRoleID eşlemesiyle sunucunuzdaki rolleri eşitleyebilirsiniz.

Bağışçı tablosu (scoreboard, hologram)

type: top-alltime, top-annual, top-monthly, top-daily, latest. limit: 1–10.

Hata yönetimi

Hata mesajları İngilizcedir ve değişebilir. Oyunculara göstereceğiniz metni error koduna göre kendi dilinizde üretin.

İpuçları

  • Önbellek: /store/listing, /store/products, /vote-links gibi sık değişmeyen verileri eklentinizde birkaç dakika önbelleğe alın.
  • Asenkron çağrı: Oyun sunucularında API çağrılarını ana iş parçacığında (main thread) yapmayın; sunucu donabilir.
  • Kullanıcı adı: Minecraft sitelerinde username parametreleri oyuncunun gerçek adıyla (realname) eşleştirilir; diğer oyunlarda hesap kullanıcı adıyla.
  • Saat dilimi: Tarihler sitenin saat dilimindedir (Discord kullanıcı ucundaki rol bitiş tarihleri hariç; onlar UTC).