api.turkishpvp.club

Turkish PvP Club API

Auth, cezalar, mağaza ve sunucu durumuna programatik erişim. REST tabanlı, JSON döner. Tüm istekler tek bir gateway üzerinden geçer.

API Key Başvurusu

Kimlik Doğrulama

Tüm isteklerde Authorization header\'ı gereklidir.

Authorization: Bearer tpc_xxxxxxxxxxxx

Rate limit

60 istek / dk

Yanıt formatı

JSON

Base URL

api.turkishpvp.club

Protokol

HTTPS / REST

Auth

/v1/auth

Oyuncu kimlik doğrulama, oturum ve hesap yönetimi.

GET
/v1/auth/auth/me

Geçerli oturumun kullanıcı bilgisini döner. Kendi uygulamanızın giriş yapmış kullanıcısını almak için kullanın.

GET
/v1/auth/auth/recent

Son kayıt olan 5 oyuncuyu döner. Kullanıcı adı ve kayıt zamanı içerir.

GET
/v1/auth/players/:username

Belirtilen oyuncu adına ait profil bilgisini döner.

POST
/v1/auth/oauth/token

PKCE ile yetkilendirme kodu karşılığında access token alır.

POST
/v1/auth/oauth/refresh

Refresh token kullanarak yeni bir access token üretir.

POST
/v1/auth/auth/logout

Aktif oturumu sonlandırır ve session cookie'yi geçersiz kılar.

Cezalar

/v1/punishments

Oyuncuların ban, mute ve kick geçmişine erişim.

GET
/v1/punishments/search?username=x

Oyuncu adına göre tüm aktif ve geçmiş cezaları sorgular.

GET
/v1/punishments/punishments

Tüm cezaları sayfalı olarak listeler. ?page ve ?limit parametrelerini destekler.

GET
/v1/punishments/bans

Sadece ban kayıtlarını döner.

GET
/v1/punishments/mutes

Sadece mute kayıtlarını döner.

GET
/v1/punishments/kicks

Sadece kick kayıtlarını döner.

GET
/v1/punishments/punishments/:id

Belirtilen ID'ye ait tek bir ceza kaydını döner.

Mağaza

/v1/store

TurkishPvP mağazasındaki ürün, kategori ve ayar bilgileri.

GET
/v1/store/categories

Mağazadaki tüm kategorileri listeler.

GET
/v1/store/categories/:id

Belirtilen kategorideki ürünleri döner.

GET
/v1/store/products

Tüm mağaza ürünlerini listeler.

GET
/v1/store/products/:id

Tek bir ürünün detaylarını döner.

GET
/v1/store/staff

Sunucu yetkili listesini rollere göre gruplu döner.

GET
/v1/store/settings/get

Mağaza genel ayarlarını döner (logo, banner, tema rengi vb.).

Sunucu Durumu

/v1/status

Minecraft sunucu ve Discord anlık istatistikleri.

GET
/v1/status/status/live

Sunucu IP, anlık oyuncu sayısı ve Discord üye sayısını döner. 60 saniye önbelleğe alınır.

Hata Kodları

401

Unauthorized

API key eksik veya geçersiz.

403

Forbidden

Bu endpoint'e erişim yetkiniz yok.

404

Not Found

İstenen kaynak bulunamadı.

429

Too Many Requests

Rate limit aşıldı. 60 saniye bekleyip tekrar deneyin.

502

Bad Gateway

Upstream servis geçici olarak ulaşılamıyor.