Skip to content

Tài liệu kỹ thuật

Tích hợp LRS trong một buổi chiều.

Môi trường sandbox

Kiểm tra môi trường bạn đang gọi và nhà cung cấp phía sau đã sẵn sàng chưa trước khi tích hợp — API không trả dữ liệu giả khi nhà cung cấp chưa được cấu hình.

EndpointGEThttps://api.lrsvn.com/v1/capabilities

Mỗi môi trường LRS kết nối tới bộ nhà cung cấp riêng (anti-cheat, VPS, tên miền…). Nếu một nhà cung cấp chưa được cấu hình, endpoint tương ứng trả 503 provider_unavailable — LRS không bao giờ bịa lệnh cấm, kết quả thực thi hay tài nguyên.

Yêu cầu

Endpoint công khai, không cần API key:

cURL
curl https://api.lrsvn.com/v1/capabilities

Phản hồi

JSON
{
  "environment": "staging",
  "features": { "shop": true, "en": true, "light_mode": true },
  "providers": {
    "anticheat": { "configured": true, "live_verified": false },
    "vps": { "configured": false, "live_verified": false }
  }
}

Phản hồi thật liệt kê thêm các nhà cung cấp khác (saas, domain, ssl, email, payment…); ví dụ trên đã rút gọn.

Trường phản hồi

TrườngKiểuMô tả
environmentstringTên môi trường đang phục vụ yêu cầu, ví dụ development, staging, production.
featuresobjectCờ tính năng của website: shop, en, light_mode.
providers.*.configuredbooleantrue khi địa chỉ và thông tin xác thực của nhà cung cấp đã được khai báo.
providers.*.live_verifiedbooleanHiện luôn là false: LRS chưa tự xác minh kết nối thật với nhà cung cấp.

Khuyến nghị khi thử nghiệm

  • Dùng một tổ chức và một API key riêng cho thử nghiệm, chỉ cấp scope cần thiết và đặt expires_at.
  • Đặt external_ref và player_id có tiền tố dễ nhận biết (ví dụ test-) cho sự kiện anti-cheat thử nghiệm; xem riêng chúng bằng GET /anticheat/events?player_id=.
  • Kiểm tra configured của nhà cung cấp cần dùng trước khi chạy kịch bản. live_verified chưa phản ánh kết nối thật, vì vậy hãy thử một yêu cầu đầu–cuối.
  • Khi thử luật xử lý, giữ automatic_ban tắt (mặc định) hoặc đưa người chơi thử vào whitelist để sự kiện chỉ được gắn cờ hay bỏ qua, không gửi lệnh cấm tới hệ thống thực thi.

Mã lỗi

HTTPMãKhi nào
402usage_payment_requiredHoá đơn phí theo lượt của anti-cheat đã quá hạn từ 14 ngày.
503provider_unavailableNhà cung cấp của dịch vụ chưa được cấu hình ở môi trường này.
503sdk_unavailableChưa có bản SDK anti-cheat nào được cấu hình để tải xuống.