Bỏ qua đến nội dung

Tài liệu kỹ thuật

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

Khi hoàn thành

Hành động khi lượt LR Link hoàn thành: kết quả có chữ ký, cấp một khoá LR License mỗi lượt, gửi webhook link.run.completed, phát mã từ kho mã bạn nạp.

Mỗi chiến dịch có danh sách actions (tab Cài đặt › Khi hoàn thành), luôn bắt đầu bằng { "type": "result" }. Hành động chạy đúng một lần khi lượt hoàn thành; poll lại trả cùng kết quả.

Kết quả có chữ ký

Luôn bật: result gồm completed, run_id, external_user, completed_at, ký cùng câu trả lời poll.

Cấp khoá LR License

JSON
{
  "type": "license",
  "app_id": "lapp_8kq2m7x4c1",
  "level": 2,
  "duration": { "value": 1, "unit": "day" },
  "max_devices": 1
}
  • app_id: ứng dụng LR License của cùng tổ chức; level phải có trong ứng dụng.
  • duration: { value, unit: minute | hour | day } tính từ lần kích hoạt đầu, hoặc null (vĩnh viễn).
  • Mỗi lượt một khoá, tạo như khi bạn tạo khoá trong dashboard (tính vào hạn mức khoá, ghi chú LR Link · <run_id>).
  • Kết quả: license_key, license_level, license_key_id, license_duration_seconds.
  • Không cấp được (tài khoản LR License tạm khoá, ứng dụng tạm dừng, hết hạn mức khoá): lượt vẫn hoàn thành với license_error; chủ tổ chức nhận thông báo.

Ứng dụng nhận khoá rồi gọi activate như bình thường.

Webhook

{ "type": "webhook" } gửi sự kiện link.run.completed tới các webhook của tổ chức có đăng ký sự kiện này (/app/settings › Webhook, nhóm LR Link). Ký X-LRS-Signature và thử lại như mọi webhook LRS.

JSON
{
  "id": "whd_3c9e1f0a7b2d4e6f8a1c3e5b7d9f0a2c",
  "event": "link.run.completed",
  "data": {
    "campaign_id": "lcmp_8kq2m7x4c1",
    "run_id": "lrun_9c2v1x",
    "external_user": "player-42",
    "completed_at": "2026-10-24T10:01:10Z",
    "license_key": "GARA-7KQ2-M7X4-C1ZD",
    "code": "GIFT-0001"
  }
}

Dùng webhook khi máy chủ của bạn cần cộng thưởng cho tài khoản external_user mà không phụ thuộc vào ứng dụng của người dùng.

Phát mã

{ "type": "code" } lấy một mã chưa dùng trong kho mã của chiến dịch (tab Cài đặt › Mã phát, hoặc API):

LệnhViệc
GET /link/campaigns/{id}/codesSố mã available, used.
POST /link/campaigns/{id}/codes{ "codes": ["…"] } 1–1000 mã mỗi lần (thân ≤ 512 KB); mã trùng bị bỏ qua (added, skipped).
DELETE /link/campaigns/{id}/codesXoá mọi mã chưa dùng (removed).

Kết quả code, hoặc code_error: "codes_exhausted" khi hết mã. Lấy mã cuối cùng thì chiến dịch tự tạm dừng và chủ tổ chức nhận thông báo; chiến dịch có hành động này phải còn mã mới chạy được. Khoá và mã được lưu niêm phong, không nằm trong nhật ký.