Kod örnekleri

Kopyala, yapıştır, yayına al.

Her uç nokta için cURL, JavaScript, Python ve PHP ile çalışan örnekler; gerçek yollar, parametreler ve yanıt alanlarıyla. Örnek anahtarı panelden aldığınız kendi anahtarınızla değiştirin.

Temel URL
https://api.ugilabs.com
Kimlik doğrulama
Bearer <key>
Anahtar biçimi
UGI-xxxx-…
Başarılı yanıt
{ status, data }

Dili bir kez seçin; sayfadaki tüm örnekler o dile geçer.

01

Kimlik doğrulama

/v1/status/{region} dışındaki tüm uç noktalar bir API anahtarı ister. Sonraki örnekler burada tanımlanan küçük ugi() yardımcısını kullanır.

  • Authorization: Bearer <key> tercih edin. X-API-Key de çalışır; ?api_key= ise anahtarı kayıtlara sızdırır.
  • CORS açıktır, ama tarayıcı kodundaki anahtar herkese açıktır. API'yi sunucunuzdan çağırın ya da panelden anahtarı kendi origin'lerinizle sınırlayın.
  • Anahtar yoksa 401 api_key_missing, yanlış veya devre dışıysa 401 api_key_invalid döner.
Dokümantasyonda incele

Anahtar Authorization başlığında gider; sonuç üç durumdan biridir. · Örnek görünüm; isimler ve sayılar kurgusaldır.

02

Discord botu

Embed ile yanıt veren /rank slash komutuna sahip, eksiksiz bir discord.js v14 botu.

  • deferReply() kullanır; yavaş sorgular Discord'un 3 saniyelik sınırına takılmaz.
  • 404 ve 429 durumlarında çökmek yerine anlaşılır mesajlar verir.
  • İki token'ı da ortam değişkenlerinde tutun, asla kodun içinde değil.
Dokümantasyonda incele

Yukarıdaki botun /rank komutuna verdiği embed yanıtı: rank, RR, galibiyet/maç ve rank simgesi. · Örnek görünüm; isimler ve sayılar kurgusaldır.

03

Oyuncu arama

Bir oyuncuyu Riot ID veya PUUID ile bulun. Adlar boşluk ve Latin dışı karakter içerebilir; ad ve etiketi her zaman URL-encode edin.

  • ?region= (varsayılan eu) bölgeyi seçer; seviye, kart ve unvan oyuncunun o bölgedeki son maçından gelir.
  • ?enrich=false seviye, kart ve unvanı atlar, yalnızca puuid, name ve tag döndürür; daha hızlıdır.
  • ?lang=tr kart ve unvan adlarını Türkçe döndürür.
Dokümantasyonda incele

/v1/account yanıtındaki card_details, title_details ve account_level alanlarıyla hazırlanmış bir profil kartı. · Örnek görünüm; isimler ve sayılar kurgusaldır.

04

Rank ve RR geçmişi

current_data, rank seviyesini (0 = Unranked, 27 = Radiant), seviye içindeki RR'yi ve aktif act'teki galibiyet ve maç sayısını içerir. as_of, son rekabetçi maçın zamanıdır.

  • Rank geçmişi 1 ile 10 arasında ?size= alır (varsayılan 5).
  • ranked_rating_earned o maçtaki RR değişimidir; sonuç bilinmiyorsa won null olabilir. tier_before, ranked_rating_before_update, refunded_rr ve was_derank_protected terfi, düşüş ve iadeleri açıklar.
  • İki uç noktanın da PUUID sürümü var: /v1/by-puuid/rank/… ve /v1/by-puuid/rank-history/….
Dokümantasyonda incele

Güncel rank ve RR /v1/rank yanıtından, son maçlardaki RR değişimi /v1/rank-history yanıtından gelir. · Örnek görünüm; isimler ve sayılar kurgusaldır.

05

Maçlar ve skor tabloları

Maç geçmişi her maç için istenen oyuncunun gözünden bir özet döndürür; maç detayı ise tüm oyuncuları, takımları ve rauntları verir.

  • ?size= paketinize göre sınırlıdır: 5 (Basic), 10 (Advanced), 20 (Premium). ?mode= size'dan önce uygulanır; ?start= ve pagination.next_start ile geriye doğru sayfalanır.
  • Özette teams, takım kimliğiyle (Blue, Red) anahtarlanmış bir nesnedir; maç detayında team_id içeren bir listedir.
  • /v1/match/{matchId} için ?region= isteğe bağlıdır; verilmezse tüm bölgeler denenir.
  • /v1/stored-matches yalnız maç depomuzdan okur (Riot sorgu maliyeti yok) ve summary ekler. Depo maçlar çekildikçe dolar; boşluklar olabilir.
Dokümantasyonda incele

/v1/matches yanıtıyla harita, ajan, K/D/A, ACS, skor ve sonuç; skor teams alanından okunur. · Örnek görünüm; isimler ve sayılar kurgusaldır.

06

Sıralama tablosu

Aktif act'in rekabetçi sıralaması. Geçmiş bir act için /v1/content üzerinden aldığınız actId değerini gönderin.

  • size 1–200 arasıdır (varsayılan 50); start, size değerinin katına aşağı yuvarlanan bir başlangıç noktasıdır ve en fazla 10.000 olabilir.
  • search, dönen sayfayı isme göre filtreler; tüm sıralamada arama yapmaz.
  • Gizli oyuncular boş tag_line ve puuid: null ile Secret Agent olarak görünür.
Dokümantasyonda incele

/v1/leaderboard ile ilk 10 oyuncu. Profilini gizleyen oyuncular Secret Agent adıyla, boş etiket ve puuid: null ile gelir. · Örnek görünüm; isimler ve sayılar kurgusaldır.

07

Oyun içeriği ve durum

İçerik; ajanları, haritaları, silah kaplamalarını, oyun modlarını, sezonları, oyuncu kartlarını ve unvanları listeler. Kimlikleri adlara eşlemek ve aktif act'i bulmak için kullanın.

  • locale yalnızca en-US ve tr-TR kabul eder; diğer değerler 400 invalid_locale döndürür.
  • /v1/status/{region} anahtar istemez ve IP başına dakikada 60 istekle sınırlıdır. Ayrıntılı tablo durum sayfasındadır.
Dokümantasyonda incele

/v1/content ajanları, haritaları ve aktif act'i; /v1/status bölge durumunu verir. · Örnek görünüm; isimler ve sayılar kurgusaldır.

08

Hata yönetimi

Hatalar her zaman {status, error, code, request_id} yapısındadır, bazen details da içerir. Mesaj metnine değil code alanına göre karar verin.

  • Yalnızca rate_limited (429) ve 503 hatalarını yeniden deneyin; önce Retry-After kadar saniye bekleyin.
  • Bir sorun bildirirken request_id değerini (X-Request-Id başlığında da bulunur) ekleyin.
Dokümantasyonda incele

Her hata bir code taşır; yeniden denenebilir olanlar yeşil işaretli. · Örnek görünüm; isimler ve sayılar kurgusaldır.

09

ETag ile önbellekleme

Her 200 yanıtı bir ETag taşır. Bunu If-None-Match ile geri gönderin: veri değişmediyse gövdesiz bir 304 Not Modified alırsınız.

  • 304 yanıtı da kotanızdan düşer, ama bant genişliğinden ve ayrıştırmadan tasarruf sağlar.
  • X-Cache: HIT, yanıtın paylaşımlı sunucu önbelleğinden geldiğini gösterir; Age kaç saniye önce kaydedildiğini, X-Cache-TTL verinin paketin için kaç saniye daha taze sayılacağını söyler (paket başına güncel değerler dokümanda).
  • Bu kodlar Kimlik doğrulama bölümündeki BASE, API_KEY ve session tanımlarını kullanır.
Dokümantasyonda incele

İkinci istek aynı ETag ile gelir; veri değişmediyse gövde boş döner. · Örnek görünüm; isimler ve sayılar kurgusaldır.

10

Webhook'lar

Takip ettiğiniz oyuncular yeni maç oynadığında ugiAPI sunucunuza imzalı bir POST gönderir. Bu alıcılar X-UGI-Signature başlığını doğrular, tekrarları ayıklar ve olay türüne göre işlem yapar.

  • İmza sha256= + HMAC-SHA256(secret, timestamp + "." + ham_gövde) değeridir; ham gövdeyi kullanın ve 5 dakikadan eski X-UGI-Timestamp değerlerini reddedin.
  • 5 saniye içinde 2xx döndürün; aksi halde 1, 5 ve 30 dakika sonra aynı X-UGI-Delivery ile yeniden denenir.
  • Bir maç birden fazla olay üretebilir: her biri ayrı bir POST'tur ve aynı changes nesnesini taşır. Paneldeki "Test gönder" düğmesi webhook.test gönderir.
Dokümantasyonda incele

Maç bitince imzalı POST sunucuna ulaşır; gövdede değişen alanlar ve güncel veri vardır. · Örnek görünüm; isimler ve sayılar kurgusaldır.

Denemeye hazır mısınız?

Bir anahtar alın, bir örneğe yapıştırın; bir dakika içinde veriniz hazır. Dokümantasyonda tüm parametreler ve etkileşimli bir playground var.