Anti-cheat SDK
Lấy thông tin tải SDK cho từng nền tảng (phiên bản, đường dẫn, mã SHA-256) và kết nối SDK với game server để báo người chơi đang online.
https://api.lrsvn.com/v1/anticheat/sdkTín hiệu phát hiện từ game được chuyển lên LRS qua game server của bạn: game server dùng API key có scope anticheat:ingest để gửi sự kiện. Không bao giờ nhúng API key vào game client.
Yêu cầu
curl https://api.lrsvn.com/v1/anticheat/sdk \
-H "Authorization: Bearer $LRS_API_KEY"Cần scope anticheat:read.
Phản hồi
{
"data": [
{
"platform": "windows",
"url": "https://downloads.lrs.vn/anticheat/windows/1.4.2/lrs-anticheat-windows.zip",
"version": "1.4.2",
"sha256": "8dbddf49c93d7fd107f31538fb2ee7250d11ddc6fd21b17ee59aabb1df0c0f67"
},
{
"platform": "unity",
"url": "https://downloads.lrs.vn/anticheat/unity/1.4.0/lrs-anticheat-unity.zip",
"version": "1.4.0",
"sha256": "909d6b7201eb21ee6eb168985c34343908790b32dadb7d5fe6cd85e89edfa374"
}
]
}Chỉ những nền tảng đã được cấu hình (đường dẫn HTTPS, có phiên bản và SHA-256 hợp lệ) mới xuất hiện trong danh sách.
Nền tảng
| Giá trị platform | Dành cho |
|---|---|
| windows | Game client trên Windows. |
| android | Ứng dụng Android. |
| ios | Ứng dụng iOS. |
| unity | Plugin cho Unity. |
| unreal | Plugin cho Unreal Engine. |
Xác minh tệp đã tải
So khớp mã SHA-256 trước khi đưa SDK vào bản dựng:
echo "8dbddf49c93d7fd107f31538fb2ee7250d11ddc6fd21b17ee59aabb1df0c0f67 lrs-anticheat-windows.zip" | sha256sum --checkBáo người chơi đang online
Game server gọi endpoint sau định kỳ cho mỗi người chơi đang kết nối (scope anticheat:ingest). Người chơi được tính là online trong 5 phút kể từ nhịp gần nhất:
curl -X POST https://api.lrsvn.com/v1/anticheat/players/heartbeat \
-H "Authorization: Bearer $LRS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{ "player_id": "player_10293" }'Phản hồi 200: { "online": true }.
Mã lỗi
| HTTP | Mã | Khi nào |
|---|---|---|
| 403 | scope_denied | Khoá thiếu scope anticheat:read (hoặc anticheat:ingest với nhịp online). |
| 422 | validation_error | fields.player_id rỗng hoặc không hợp lệ. |
| 503 | sdk_unavailable | Chưa có bản SDK nào được cấu hình để tải xuống. |