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.
EndpointGET
https://api.lrsvn.com/v1/capabilitiesMỗ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 https://api.lrsvn.com/v1/capabilitiesPhản hồi
{
"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ường | Kiểu | Mô tả |
|---|---|---|
| environment | string | Tên môi trường đang phục vụ yêu cầu, ví dụ development, staging, production. |
| features | object | Cờ tính năng của website: shop, en, light_mode. |
| providers.*.configured | boolean | true khi địa chỉ và thông tin xác thực của nhà cung cấp đã được khai báo. |
| providers.*.live_verified | boolean | Hiệ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_refvàplayer_idcó 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ằngGET /anticheat/events?player_id=. - Kiểm tra
configuredcủa nhà cung cấp cần dùng trước khi chạy kịch bản.live_verifiedchư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_bantắt (mặc định) hoặc đưa người chơi thử vàowhitelistđể 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
| HTTP | Mã | Khi nào |
|---|---|---|
| 402 | usage_payment_required | Hoá đơn phí theo lượt của anti-cheat đã quá hạn từ 14 ngày. |
| 503 | provider_unavailable | Nhà cung cấp của dịch vụ chưa được cấu hình ở môi trường này. |
| 503 | sdk_unavailable | Chưa có bản SDK anti-cheat nào được cấu hình để tải xuống. |