check — kiểm tra định kỳ
Gọi định kỳ khi phần mềm đang chạy: LRS đọc lại khoá, thiết bị và danh sách chặn rồi gia hạn phiên. Khoá bị thu hồi hay hết hạn được báo ở lần check kế tiếp.
https://api.lrsvn.com/v1/license/client/checkĐặt chu kỳ ngắn hơn thời hạn phiên (SDK mặc định 5 phút). Mỗi check thành công dời session_expires_at thêm một thời hạn phiên, cũng tính như một heartbeat, và được tính vào hạn mức ngày. Giữa hai lần check, gửi heartbeat để phiên không bị coi là im lặng.
Yêu cầu
curl -X POST https://api.lrsvn.com/v1/license/client/check \
-H "Content-Type: application/json" \
-d '{ "app_id": "lapp_8kq2m7x4c1", "session": "lss_Xr2…", "hwid": "5ec6c161bd363271f7b09facdd5fe8b1a18fc04a0c89daea81fe0a6a44d12dc1", "nonce": "a8Vt0pXq3Lm5Rz7cKw2yNb4d" }'Header
| Header | Giá trị |
|---|---|
| Content-Type | application/json |
| Authorization | Không gửi. Client API là công khai; gửi kèm một giá trị không phải Bearer lrs_… sẽ bị cổng API từ chối 401. |
| Idempotency-Key | Không cần — gọi lại check bao nhiêu lần cũng được. |
Thân JSON tối đa 8 KB. Trường lạ được bỏ qua (SDK mới hơn có thể gửi thêm trường).
Tham số
| Tham số | Kiểu | Mô tả |
|---|---|---|
| app_id | string | Bắt buộc. lapp_… của ứng dụng. |
| nonce | string | Bắt buộc. Mới cho mỗi lần gọi. |
| session | string | session nhận từ activate. |
| hwid | string | Đúng HWID đã gửi lúc activate. Chỉ được so với phiên ràng buộc hwid. |
Phản hồi
HTTP/1.1 200 OK
X-LR-Signature: lsk_4h7q2x9m=…
{
"app": { "latest_version": "1.4.3" },
"app_id": "lapp_8kq2m7x4c1",
"code": "ok",
"files": [
{
"filename": "ph-garage-1.4.2.zip",
"id": "lfil_3vn8q1k0ze",
"name": "PH Garage Script",
"sha256": "9f2c41d7a0b3e6c58d21f4a97c0e3b51d8a4f2c67e19b05d3c4a8e2f6d5e0b7f",
"size": 192937984,
"version": "1.4.2",
"version_id": "lfv_4h2m8q1x7c"
}
],
"license": {
"binding": "hwid",
"devices": 1,
"expires_at": "2026-11-23T03:15:00Z",
"level": 2,
"level_name": "VIP",
"max_concurrent_sessions": 1,
"max_devices": 1
},
"message": "Khoá hợp lệ.",
"next_heartbeat_in": 20,
"nonce": "a8Vt0pXq3Lm5Rz7cKw2yNb4d",
"ok": true,
"server_time": "2026-10-24T03:20:00Z",
"session_expires_at": "2026-10-24T04:20:00Z"
}check không trả session mới: tiếp tục dùng mã cũ. app.latest_version cho biết có bản mới để nhắc người dùng; check không chặn theo phiên bản.
files giống activate và luôn là danh sách hiện tại: tệp vừa được gắn với khoá, bản hiện hành mới (version_id đổi) hoặc tệp bị gỡ khỏi khoá hiện ra ở lần check kế tiếp — so version_id với bản đã tải để biết khi nào cần tải lại.
Mã lỗi
| Mã | HTTP · ký | Khi nào và cách xử lý |
|---|---|---|
| app_not_found | 200 · không ký | app_id không tồn tại hoặc ứng dụng đã bị xoá — server không có khoá để ký. Xử lý: Coi như chữ ký sai (invalid_signature): không mở phần mềm. Thường do nhúng nhầm app_id. |
| app_paused | 200 · có ký | Người bán đang tạm dừng ứng dụng. Xử lý: Từ chối, hiện thông báo; thử lại sau. |
| app_suspended | 200 · có ký | LRS tạm khoá ứng dụng hoặc tài khoản LR License của người bán. Xử lý: Từ chối, đề nghị người dùng liên hệ người bán. |
| session_invalid | 200 · có ký | Mã phiên không có, hoặc phiên đã đóng bằng end. Xử lý: Gọi lại activate với khoá đã lưu; nếu vẫn từ chối thì dừng. |
| session_expired | 200 · có ký | Quá session_expires_at mà không có check, hoặc — khi khoá có giới hạn phiên — im lặng (không heartbeat/check) quá heartbeat_timeout_seconds. Xử lý: Gọi lại activate (có thể gặp session_limit nếu chỗ đã bị máy khác lấy). Giữ đúng nhịp heartbeat. |
| session_replaced | 200 · có ký | Phiên bị thay: cùng máy kích hoạt lại, hoặc máy khác kích hoạt khi ứng dụng chọn kick_oldest. Xử lý: Dừng vòng heartbeat/check và báo người dùng khoá đang chạy nơi khác. Không tự kích hoạt lại liên tục (hai máy sẽ đẩy nhau). |
| session_revoked | 200 · có ký | Người bán kết thúc phiên, thu hồi hoặc xoá khoá, reset hay gỡ thiết bị, hoặc chặn HWID. Xử lý: Dừng tính năng đang chạy. Chỉ kích hoạt lại khi người dùng chủ động. |
| hwid_mismatch | 200 · có ký | Phiên ràng buộc thiết bị: hwid gửi kèm check khác HWID lúc activate. Xử lý: Gọi lại activate trên máy này (sẽ chiếm thêm một chỗ thiết bị). |
| blocked | 200 · có ký | HWID hoặc IP nằm trong danh sách chặn của ứng dụng. Xử lý: Từ chối. |
| key_invalid | 200 · có ký | Khoá sai, trống, đã bị xoá, hoặc không thuộc ứng dụng. Xử lý: Mời nhập lại khoá. Không thử lại tự động (bị tính là dò khoá). |
| key_revoked | 200 · có ký | Người bán đã thu hồi khoá. Mọi phiên của khoá cũng kết thúc. Xử lý: Từ chối, dừng tính năng đang chạy. |
| key_expired | 200 · có ký | Khoá đã quá expires_at. Xử lý: Từ chối, mời gia hạn với người bán. |
| quota_exceeded | 200 · có ký | Tổ chức của người bán đã dùng hết hạn mức lượt gọi trong ngày (theo giờ Việt Nam). Xử lý: Tạm thời: nếu đã có lần check thành công gần đây thì cho chạy tiếp trong thời gian ân hạn, thử lại sau. |
| invalid_request | 422 · thường có ký | Trường sai định dạng; fields nêu trường lỗi. Không ký nếu chính app_id sai hoặc JSON hỏng. Xử lý: Lỗi tích hợp: sửa theo fields, không thử lại nguyên văn. |
| rate_limited | 429 · tuỳ trường hợp | Theo mạng (không ký), theo khoá hoặc do dò khoá (có ký) — xem mục Thử lại. Xử lý: Chờ retry_after / Retry-After giây rồi thử lại. |
| license_busy | 503 · không ký | Máy chủ đang bận, không nhận thêm lượt gọi trong 1 giây. Xử lý: Lỗi mạng tạm thời: thử lại sau Retry-After. |
Hạn khoá được so tới giây ở mỗi check (và heartbeat): khoá ngắn (ví dụ 45 phút) hết hạn ngay giữa phiên thì lần gọi kế tiếp trả key_expired — phần mềm nên dừng tính năng và báo người dùng gia hạn. Ở check, key_invalid nghĩa là người bán đã xoá khoá. Thu hồi khoá, reset thiết bị hoặc kết thúc phiên trong dashboard đóng phiên ngay, nên phần mềm nhận session_revoked.
Thử lại
Phân biệt hai loại câu trả lời trước khi đọc code:
- Có chữ ký hợp lệ (HTTP 200, 422, 429 theo khoá): đây là kết luận của LRS. Làm theo bảng mã lỗi;
ok: truechỉ có ở loại này. - Không có header
X-LR-Signaturevà HTTP khác 200 (429 theo mạng, 503license_busy, 502 của cổng API, mất mạng): coi lànetwork_error— không bao giờ là thành công, cũng không phải lý do khoá người dùng. ĐọcRetry-After(giây) rồi thử lại với nonce mới. - HTTP 200 không có chữ ký (
app_not_found) hoặc có header nhưng không chữ ký nào hợp lệ:invalid_signature— từ chối.
Đừng dừng phần mềm ngay khi lỗi mạng. SDK báo kết quả network_error để bạn tự quyết; ví dụ FiveM trong gói Node chỉ dừng sau 3 lần xác thực thất bại liên tiếp và quá 15 phút ân hạn, tính theo server_time đã ký của lần check thành công gần nhất.