Hızlı başlangıç

Beş adım, nerede kaldığın işaretli; tamamlananlar için tekrar bir şey yapman gerekmiyor.

  1. 1

    Giriş yap

    Sıradaki

    Başvuru ve anahtarlar TurkishPvP hesabına bağlanıyor. E-posta adresi yalnızca iletişim alanı, tek başına sahiplik kanıtı değil.

    Giriş yap
  2. 2

    Başvur

    Projeni anlat ve her izin için gerekçe yaz. Gerekçesiz istenen izin genellikle verilmiyor. Gönderirken kullanım koşullarının o anki sürümünü kabul ediyorsun.

    Başvuruya git
  3. 3

    İncelemeyi bekle

    İnceleyen ek bilgi isteyebilir; bu durumda başvuru sana geri açılıyor ve aynı formdan güncelliyorsun. İzinler tek tek veriliyor, hepsi birden değil.

  4. 4

    Anahtar üret

    Anahtarı uygulamanın sayfasından sen üretiyorsun. Ham değer yalnızca bir kez görünüyor; kaybedersen gösterilemiyor, yenileniyor.

  5. 5

    İlk çağrını yap

    Anahtarını Authorization başlığında gönder. Örnek, izin verilen en basit uç nokta:

    curl -H "Authorization: Bearer tpc_..." \
  https://api.turkishpvp.club/v1/status/live

    Gereken izin: status.read · Dakikalık sınır: 120 istek

    { "online": true, "players": 42, "maxPlayers": 500 }

İlk çağrı çalışmazsa

Yanıttaki code alanı ne olduğunu söylüyor. Reddedilen istekler de istek geçmişinde duruyor, yani kendi günlüğüne bakmadan da görebilirsin.

  • missing_keyAuthorization başlığı yok ya da Bearer biçiminde değil.Başlığı `Authorization: Bearer <anahtar>` biçiminde gönder.
  • invalid_keyAnahtar tanınmadı, iptal edilmiş ya da süresi dolmuş.Anahtarın iptal edilmiş ya da süresi dolmuş olabilir; uygulama sayfasından bak.
  • unknown_endpointBu yol dışarı açık değil.Yolu referanstaki hâliyle karşılaştır; listede olmayan yol açılmıyor.
  • scope_deniedAnahtarın bu uç nokta için gereken izni yok.Bu izin uygulamana verilmemiş. Kapsam genişletmek yeni bir inceleme istiyor.
  • rate_limitedDakikalık istek sınırı aşıldı.Yanıttaki `retry-after` kadar bekle, sonra tekrar dene.
  • upstream_unavailableKaynak servise ulaşılamadı.Geçici. Aynı isteği biraz sonra tekrarla.
  • limiter_unavailableİstek sayacına ulaşılamadı, istek güvenli tarafta reddedildi.Geçici. Sayaç okunamadığında istek güvenli tarafta reddediliyor.