Bỏ qua tới nội dung chính
Cấu hình nền tảng & môi trường Riot Games API

Cài đặt & API

API được quản lý và bảo mật qua file cấu hình môi trường .env.

Giao thức Riot Games API trực tiếp đang hoạt động

Riot trực tiếp

Hệ thống đã nhận diện RIOT_API_KEY trong file .env và đang kết nối trực tiếp đến Riot Games API (Account-v1, Summoner-v4, Match-v5).

Phạm vi lịch sử đấu dùng để đánh giá

Hiện tại: 50 trận gần nhất

Hệ thống chỉ lấy N trận gần nhất của mỗi tuyển thủ để tính các chỉ số hiển thị: KDA, CS/phút, tỉ lệ thắng, biểu đồ radar phong độ. Đổi giá trị sẽ tính lại các chỉ số này ngay lập tức (không ảnh hưởng điểm xếp hạng — điểm chỉ đổi qua trận Custom mới, xem trang chi tiết tuyển thủ).

Thông số môi trường (.env)

Chỉ đọc từ file .env
RIOT_API_KEY
Đã cấu hình & hoạt động
RGAPI-11••••••••••••••••6882
RIOT_DEFAULT_REGION
vn2
Định tuyến máy chủ
Regional cluster
sea
Match-v5 & Account-v1
Cấu hình trong .env tại thư mục gốc dự án: developer.riotgames.com
# Riot Games API Configuration
RIOT_API_KEY=RGAPI-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RIOT_DEFAULT_REGION=vn2

Sau khi thêm hoặc thay đổi API key trong .env, hệ thống tự áp dụng ngay cho các lượt query và đồng bộ lịch sử đấu.

App Overlay / Desktop Companion

Đã cấu hình

App overlay chạy trên máy người chơi (hook vào League Client) sẽ tự động đẩy dữ liệu trận Tùy Chọn lên hệ thống ngay sau khi kết thúc trận — dùng thông số dưới đây để cấu hình lúc setup lần đầu. Chỉ cần 1 người trong lobby chạy app là đủ ghi nhận cho cả trận.

TopTier Overlay — v0.5.0 (Windows)
File .exe chạy trực tiếp (portable), không cần cài đặt.
Tải TopTier Overlay (.exe)

File chưa được ký số nên Windows SmartScreen có thể cảnh báo "Unknown publisher" khi mở lần đầu — bấm "More info" → "Run anyway" để tiếp tục (bình thường với app nội bộ chưa mua chứng chỉ ký số).

OVERLAY_INGEST_TOKEN
Đã cấu hình
Xh6l••••••••••••••••o1q0
Endpoint đẩy dữ liệu trận
https://toptier.ocyon.net/api/overlay/matches
POST kèm Authorization: Bearer <token>
Cấu hình trong .env tại thư mục gốc dự án:
# Overlay App Ingestion Token
OVERLAY_INGEST_TOKEN=

Tạo một chuỗi ngẫu nhiên đủ dài (VD: php artisan tinker → Str::random(40)) rồi dán vào đây và vào app overlay lúc thiết lập lần đầu. Sau khi đổi giá trị, cần khởi động lại server (hoặc php artisan config:clear) để áp dụng.

Công cụ kiểm tra kết nối Riot ID

Thử tra cứu nhanh một Riot ID để kiểm tra phản hồi từ Riot Games API theo thông số trong .env.