Değişiklik günlüğü
ugiAPI sürümlerinde eklenen ve değişen özellikler.
-
v1.2.0
Güncel-
Yeni
/v1/stored-matches/{region}/{name}/{tag}ve/v1/by-puuid/stored-matches/{region}/{puuid}: maç depomuzdaki maçlar; mod, harita, ajan ve act filtreleri, sayfalama ve özet (kazanma %, K/D, headshot %, ADR, ACS). Riot sorgu maliyeti yok. -
Maç Geçmişi:
?mode=filtresi (Riot tarafındasize'dan önce uygulanır; istediğiniz sayıda o moddan maç gelir) vepagination.next_startile?start=sayfalaması. -
Maç Geçmişi ve maç detayı: oyuncu başına yeni
combatnesnesi (vücut bölgesine göre isabet, headshot %, verilen/alınan hasar, ADR, ilk kill/ölüm, ekonomi). Maç detayındaki turlardafirst_kill. -
Rank geçmişi:
tier_before,tier_change,ranked_rating_before_update,performance_bonus,refunded_rr,was_derank_protectedveseason_id(aynı Riot yanıtı, ek maliyet yok; Riot bir alanı göndermezse null). -
Rank: yeni
peaknesnesi (tüm act'lerdeki en yüksek kademe). Ek sorgu maliyeti yok. -
Yeni başlıklar:
X-Upstream-Cost(bu isteğin harcadığı Riot sorgusu) ve IETFRateLimit-Policy/RateLimit. Eski/v1/mmr*yolları artıkDeprecationveLink: rel="successor-version"gönderir. -
OpenAPI 3.1 tanımı
/openapi.jsonadresinde (/llms.txtiçinden de bağlantılı).
-
Yeni
-
v1.1.0
- Pakete göre veri tazeliği: canlı veriler (hesap, rank, rank geçmişi, maç listesi) Basic'te en fazla 300 sn, Advanced'da 120 sn, Premium'da 30 sn eski olabilir. Daha eski kayıt yeniden çekilir.
-
Premium için
?force=true: canlı veride önbelleği atlar (aynı oyuncu ve uç nokta için 10 saniyede bir). Diğer paketler400 force_not_allowedalır. -
Yeni
X-Cache-TTLbaşlığı: önbellekten gelen yanıtta verinin paketin için kaç saniye daha taze sayılacağı. -
Riot sorgu bütçesi başlıkları:
X-RateLimit-Upstream-Limit / -Remaining / -ResetveX-RateLimit-Upstream-Daily-*. Tarayıcıdan da okunabilir (CORS). -
Rank yanıtına
by_season: act başına son tier ve RR, galibiyet, maç sayısı, en yüksek galibiyet tier'ı ve liderlik sırası (ek sorgu maliyeti yok). -
Webhook'lar ve takip edilen oyuncular: oyuncuyu sürekli sorgulamak yerine yeni maç, seviye ya da rank değişince bildirim al (
match.new,account.level_changed,rank.changed). Advanced 10 oyuncu / 5 dk, Premium 50 oyuncu / 1 dk. -
Webhook gönderimleri
X-UGI-Signature(HMAC-SHA256) ile imzalanır; yalnızca https ve genel IP adreslerine gönderilir, yönlendirme izlenmez. Başarısız gönderim 1, 5 ve 30 dk sonra tekrar denenir. - Panel: anahtar kartında ve ayrıntılarında veri tazeliği; yeni Webhook sayfası (secret, test gönderimi, oyuncu listesi, son gönderimler).
-
Dokümana webhook bölümü, imza doğrulama örnekleri (PHP, Node.js, Python), bu değişiklik günlüğü ve
/llms.txt. -
Pakete göre yenileme geçici olarak yapılamazsa (bütçe ya da kesinti) süresi dolmamış önbellek kaydı hata yerine sunulur (
X-Cache-TTL: 0).
-
v1.0.4
- Hesap, rank, rank geçmişi, maç listesi, maç detayı, liderlik tablosu, içerik ve durum uç noktaları; anahtar başına dakika/gün kotaları, Riot sorgu bütçesi, IP/Origin kısıtları, ETag/304 ve tutarlı hata gövdesi.
Makineler için kısa özet: /llms.txt.