Değişiklik günlüğü

ugiAPI sürümlerinde eklenen ve değişen özellikler.

  1. 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ında size'dan önce uygulanır; istediğiniz sayıda o moddan maç gelir) ve pagination.next_start ile ?start= sayfalaması.
    • Maç Geçmişi ve maç detayı: oyuncu başına yeni combat nesnesi (vücut bölgesine göre isabet, headshot %, verilen/alınan hasar, ADR, ilk kill/ölüm, ekonomi). Maç detayındaki turlarda first_kill.
    • Rank geçmişi: tier_before, tier_change, ranked_rating_before_update, performance_bonus, refunded_rr, was_derank_protected ve season_id (aynı Riot yanıtı, ek maliyet yok; Riot bir alanı göndermezse null).
    • Rank: yeni peak nesnesi (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 IETF RateLimit-Policy / RateLimit. Eski /v1/mmr* yolları artık Deprecation ve Link: rel="successor-version" gönderir.
    • OpenAPI 3.1 tanımı /openapi.json adresinde (/llms.txt içinden de bağlantılı).
  2. 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 paketler 400 force_not_allowed alır.
    • Yeni X-Cache-TTL baş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 / -Reset ve X-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).
  3. 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.