init — kiểm tra ứng dụng
Gọi lúc khởi động để biết ứng dụng còn chạy không và bản phần mềm có hợp lệ không (phiên bản tối thiểu, hash bản dựng). Không cần khoá.
https://api.lrsvn.com/v1/license/client/initinit không bắt buộc và không tính vào hạn mức ngày. Dùng nó để báo sớm "cần cập nhật" trước khi hỏi khoá; activate vẫn tự kiểm tra lại phiên bản và hash.
Yêu cầu
curl -X POST https://api.lrsvn.com/v1/license/client/init \
-H "Content-Type: application/json" \
-d '{ "app_id": "lapp_8kq2m7x4c1", "version": "1.4.2", "hash": "44575cf5b28512d75644bf54a517dcef304ff809fd511747621b4d64f19aac66", "nonce": "Q2x8n3VYk1pR7tLm0aZc4dWe" }'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. 16–64 ký tự [A-Za-z0-9_-], mới cho mỗi lần gọi. |
| version | string | Phiên bản phần mềm, tối đa 32 ký tự, so từng phần số (1.10 > 1.9). Bắt buộc trên thực tế khi ứng dụng đặt min_version: bỏ trống bị coi là thấp hơn. |
| hash | string | SHA-256 dạng hex (64 ký tự) của bản dựng. Bắt buộc khi ứng dụng khai báo integrity_hashes. |
Phản hồi
HTTP/1.1 200 OK
X-LR-Signature: lsk_4h7q2x9m=…
{
"app": {
"binding": "hwid",
"heartbeat_timeout_seconds": 60,
"hwid_required": true,
"latest_version": "1.4.2"
},
"app_id": "lapp_8kq2m7x4c1",
"code": "ok",
"message": "Khoá hợp lệ.",
"nonce": "Q2x8n3VYk1pR7tLm0aZc4dWe",
"ok": true,
"server_time": "2026-10-24T03:15:00Z"
}Thân thật là JSON gọn trên một dòng, khoá theo thứ tự bảng chữ cái như trên. Xác minh chữ ký trên đúng byte nhận được, không trên bản định dạng lại.
Khi cần cập nhật, câu trả lời có thêm thông tin tải bản mới:
{
"app_id": "lapp_8kq2m7x4c1",
"code": "update_required",
"download_url": "https://lrsvn.com/dl/lapp_8kq2m7x4c1",
"latest_version": "1.4.2",
"message": "Vui lòng cập nhật phiên bản mới.",
"min_version": "1.4.0",
"nonce": "Q2x8n3VYk1pR7tLm0aZc4dWe",
"ok": false,
"server_time": "2026-10-24T03:15:00Z",
"update_file_id": "lfil_3vn8q1k0ze"
}download_url là Link tải bản mới trong Cài đặt của ứng dụng; nếu để trống mà đã chọn Tệp cập nhật, nó là trang tải cho khách https://lrsvn.com/dl/<app_id> (khách nhập khoá để tải). update_file_id chỉ có khi ứng dụng chọn tệp cập nhật: phần mềm có thể activate bằng bản cũ không được, nên hãy mở download_url cho người dùng — xem Tệp tải về.
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. |
| update_required | 200 · có ký | version thấp hơn min_version của ứng dụng. Có latest_version, min_version, download_url (link tải bản mới của ứng dụng; chưa đặt mà có tệp cập nhật thì là trang tải https://lrsvn.com/dl/<app_id>) và update_file_id khi ứng dụng chọn tệp cập nhật. Xử lý: Từ chối, mở download_url để cập nhật — hoặc tải thẳng update_file_id bằng download sau khi có phiên (xem Tệp tải về). |
| integrity_failed | 200 · có ký | Ứng dụng có danh sách integrity_hashes mà hash gửi lên không nằm trong đó (kể cả khi không gửi hash). Xử lý: Từ chối: bản phần mềm bị sửa hoặc chưa khai báo hash bản dựng mới. |
| 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. |
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.