API Giriş

ugiAPI API dokümantasyonuna hoş geldiniz. API'miz geliştiricilerin Valorant oyuncu istatistiklerine, maç geçmişine, MMR verilerine ve bölgesel sıralamalara programatik olarak kolayca erişmesini sağlar.

Temel URL:

https://api.ugilabs.com

Kimlik Doğrulama

Tüm API istekleri bir API Anahtarı kullanılarak doğrulanmalıdır. Anahtarınızı Geliştirici Panelinden alabilirsiniz.

API Anahtarını Gönderme

API anahtarınızı göndermek için iki yöntemi destekliyoruz:

Seçenek 1 Authorization Başlığı (Önerilen)

Authorization: Bearer VLAPI-XXXX-XXXX-XXXX

Seçenek 2 Sorgu Parametresi

GET /v1/account/Player/Tag?api_key=VLAPI-XXXX-XXXX-XXXX

Hız Sınırları (Rate Limiting)

API kullanımı planınıza göre sınırlıdır. Hız sınırları API anahtarı başına uygulanır.

Plan Tipi	Hız Sınırı	Kullanım Amacı
Standart	20 istek / dk	Kişisel Projeler
Advanced	60 istek / dk	Discord Botları ve Gelişen Projeler
Premium	300 istek / dk	Prodüksiyon Uygulamaları

Kullanımınızı izlemek için X-RateLimit-Limit, X-RateLimit-Remaining, ve X-RateLimit-Reset yanıt başlıklarını kontrol edin.

Hatalar

API, başarı veya başarısızlığı belirtmek için standart HTTP yanıt kodlarını kullanır.

Kod	Açıklama
200	OK: İstek başarılı.
400	Bad Request: Geçersiz parametreler.
401	Unauthorized: Eksik API anahtarı.
403	Forbidden: Geçersiz veya pasif API anahtarı.
404	Not Found: Verilen parametreler için veri bulunamadı.
429	Too Many Requests: Hız sınırı aşıldı.
500	Internal Server Error: Bizim tarafımızda bir şeyler ters gitti.
503	Service Unavailable: Riot API kapalı veya bakımda.

GET

Hesap Bilgileri

/v1/account/{name}/{tag}

Bir Valorant oyuncusu için temel hesap detaylarını Riot ID kullanarak getirir. PUUID, hesap seviyesi, oyuncu kartı ve ünvanı döner.

Parametreler

İsim	Konum	Tip
name	path	Riot ID İsmi
tag	path	Riot ID Etiketi (# yok)

curl -X GET "https://api.ugilabs.com/v1/account/TenZ/0505" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/account/TenZ/0505");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/account/TenZ/0505"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

fetch("https://api.ugilabs.com/v1/account/TenZ/0505", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

PUUID ile Hesap Bilgileri

/v1/by-puuid/account/{puuid}

Bir Valorant oyuncusu için temel hesap detaylarını oyuncunun benzersiz PUUID'sini kullanarak getirir.

Parametreler

İsim	Konum	Tip
puuid	path	Oyuncunun benzersiz PUUID kodu

curl -X GET "https://api.ugilabs.com/v1/by-puuid/account/4a82a0d1-..." \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/by-puuid/account/4a82a0d1-...");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/by-puuid/account/4a82a0d1-..."
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

fetch("https://api.ugilabs.com/v1/by-puuid/account/4a82a0d1-...", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

MMR / Sıralama

/v1/mmr/{region}/{name}/{tag}

Bir oyuncunun güncel rütbesini, rekabetçi kademesini ve ELO puanlarını getirir.

Parametreler

İsim	Konum	Tip
region	path	Bölge kodu (eu, na, ap, kr)
name	path	Riot ID İsmi
tag	path	Riot ID Etiketi (# yok)

curl -X GET "https://api.ugilabs.com/v1/mmr/eu/TenZ/0505" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/mmr/eu/TenZ/0505");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/mmr/eu/TenZ/0505"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

fetch("https://api.ugilabs.com/v1/mmr/eu/TenZ/0505", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

MMR Geçmişi

/v1/mmr-history/{region}/{name}/{tag}

Bir oyuncunun son rekabetçi maçlardaki MMR ve rütbe değişim geçmişini getirir.

Parametreler

İsim	Konum	Tip
region	path	Bölge kodu (eu, na, ap, kr)
name	path	Riot ID İsmi
tag	path	Riot ID Etiketi (# yok)

curl -X GET "https://api.ugilabs.com/v1/mmr-history/eu/TenZ/0505" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/mmr-history/eu/TenZ/0505");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/mmr-history/eu/TenZ/0505"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

fetch("https://api.ugilabs.com/v1/mmr-history/eu/TenZ/0505", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

PUUID ile MMR / Sıralama

/v1/by-puuid/mmr/{region}/{puuid}

Bir oyuncunun güncel rütbesini, rekabetçi kademesini ve ELO puanlarını oyuncunun benzersiz PUUID'sini kullanarak getirir.

Parametreler

İsim	Konum	Tip
region	path	Bölge kodu (eu, na, ap, kr)
puuid	path	Oyuncunun benzersiz PUUID kodu

curl -X GET "https://api.ugilabs.com/v1/by-puuid/mmr/eu/4a82a0d1-..." \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/by-puuid/mmr/eu/4a82a0d1-...");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/by-puuid/mmr/eu/4a82a0d1-..."
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

fetch("https://api.ugilabs.com/v1/by-puuid/mmr/eu/4a82a0d1-...", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

Maç Geçmişi

/v1/matches/{region}/{name}/{tag}

Bir oyuncunun son 5 maçını getirir.

Parametreler

İsim	Konum	Tip
region	path	Bölge kodu (eu, na, ap, kr)
name	path	Riot ID İsmi
tag	path	Riot ID Etiketi (# yok)

Sorgu Parametreleri

size

İsteğe bağlı. Dönecek maç sayısı (varsayılan 5, maks 20).

curl -X GET "https://api.ugilabs.com/v1/matches/eu/TenZ/0505?size=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/matches/eu/TenZ/0505?size=5");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/matches/eu/TenZ/0505"
params = {"size": 5}
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
print(response.json())

fetch("https://api.ugilabs.com/v1/matches/eu/TenZ/0505?size=5", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

PUUID ile Maç Geçmişi

/v1/by-puuid/matches/{region}/{puuid}

Bir oyuncunun son maç geçmişini oyuncunun benzersiz PUUID'sini kullanarak getirir.

Parametreler

İsim	Konum	Tip
region	path	Bölge kodu (eu, na, ap, kr)
puuid	path	Oyuncunun benzersiz PUUID kodu

Sorgu Parametreleri

size

İsteğe bağlı. Dönecek maç sayısı (varsayılan 5, maks 20).

curl -X GET "https://api.ugilabs.com/v1/by-puuid/matches/eu/4a82a0d1-...?size=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/by-puuid/matches/eu/4a82a0d1-...?size=5");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/by-puuid/matches/eu/4a82a0d1-..."
params = {"size": 5}
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
print(response.json())

fetch("https://api.ugilabs.com/v1/by-puuid/matches/eu/4a82a0d1-...?size=5", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

Maç Detayları

/v1/match/{matchId}

Belirli bir maç hakkında oyuncu istatistikleri, tur sonuçları ve ekonomi dahil detaylı bilgi getirir.

Parametreler

İsim	Konum	Tip
matchId	path	Maçın UUID'si

curl -X GET "https://api.ugilabs.com/v1/match/e20f..." \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/match/e20f...");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/match/e20f..."
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

fetch("https://api.ugilabs.com/v1/match/e20f...", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

Liderlik Tablosu

/v1/leaderboard/{region}

Belirli bir bölge için en iyi oyuncuları getirir.

Parametreler

İsim	Konum	Tip
region	path	Bölge kodu (eu, na, ap, kr)

Sorgu Parametreleri

size

İsteğe bağlı. Dönecek oyuncu sayısı (varsayılan 50).

start

İsteğe bağlı. Başlangıç sıralama ofseti (varsayılan 0).

act

İsteğe bağlı. Liderlik tablosu alınacak Act ID'si.

curl -X GET "https://api.ugilabs.com/v1/leaderboard/eu?size=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/leaderboard/eu?size=50");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/leaderboard/eu"
params = {"size": 50}
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
print(response.json())

fetch("https://api.ugilabs.com/v1/leaderboard/eu?size=50", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

Oyun İçeriği

/v1/content

Ajanlar, haritalar, renkler ve kaplamalar gibi statik oyun içeriklerini getirir.

Sorgu Parametreleri

locale

İsteğe bağlı. Dil kodu (örn. 'en-US', 'tr-TR'). Varsayılan 'en-US'.

curl -X GET "https://api.ugilabs.com/v1/content?locale=en-US" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/content?locale=en-US");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/content"
params = {"locale": "en-US"}
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers, params=params)
print(response.json())

fetch("https://api.ugilabs.com/v1/content?locale=en-US", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

GET

Sunucu Durumu

/v1/status/{region}

Belirli bir bölge için Valorant sunucularının güncel durumunu getirir.

Parametreler

İsim	Konum	Tip
region	path	Bölge kodu (eu, na, ap, kr)

curl -X GET "https://api.ugilabs.com/v1/status/eu" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.ugilabs.com/v1/status/eu");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);

import requests

url = "https://api.ugilabs.com/v1/status/eu"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

fetch("https://api.ugilabs.com/v1/status/eu", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
.then(res => res.json())
.then(data => console.log(data));

Try It

Response

API Test Alanı (Playground)

API uç noktalarını doğrudan tarayıcınızdan test edin.

API Anahtarı

Uç Nokta

Yöntem

GET

Yanıt JSON