TapHoaTools

Developer Docs

Everything you need to integrate our licensing API into your applications.

Tài liệu tích hợp

Cách tích hợp license key

Đưa phần này cho dev đang tích hợp license vào sản phẩm. Activate một lần, sau đó verify mỗi khi app cần mở tính năng trả phí.

Nhận license key từ khách hàng hoặc tester.

Tạo và lưu một fingerprint thiết bị cục bộ.

Nếu verify trả về DEVICE_NOT_ACTIVATED, gọi POST /licenses/activate một lần để gắn key với thiết bị.

Gọi POST /licenses/verify khi mở app và trước các thao tác premium.

Chỉ mở khóa khi valid là true và reason là VALID.

Dùng https://toolvibe.vn/api/v1 làm API base URL backend của bạn. localhost chỉ dùng khi phát triển local.

Header runtime bắt buộc

X-Product-Client-Id: stg_client_idX-Product-Client-Secret: pcs_client_secret

Dùng credential staging với key TST khi dev. Chỉ dùng credential production với key LIC đã mua.

POST/licenses/activate

Gắn license key với device fingerprint hiện tại. Gọi một lần sau khi user nhập key.

POST/licenses/verify

Kiểm tra key có hợp lệ với thiết bị này không trước khi mở tính năng trả phí.

GET/licenses/me

Trả về license của buyer đã đăng nhập. Dùng cho màn tài khoản, không dùng để unlock runtime.

GET/licenses/seller

Trả về license và activation phía seller để dùng trong dashboard vận hành.

Verify dùng POST, không dùng GET, vì request có license key và device fingerprint. Các endpoint GET chỉ dùng để lấy danh sách license/account.

Nếu verify trả về DEVICE_NOT_ACTIVATED, hãy gọi activate một lần cho thiết bị đó, rồi verify lại trước khi mở tính năng trả phí.