Tài liệu tích hợp
Tài liệu tích hợp license key
Toàn bộ luồng activate, verify và quản lý license để đưa vào ứng dụng của bạn.
Base URL
https://toolvibe.vn/api/v1Đây là production API base URL dùng cho partner test và runtime integration.
Quy trình seller cần làm trước khi đưa cho AI build
B1 - Upload draft product
Seller cần upload bản draft trước trong Seller Dashboard. Draft này tạo ra sản phẩm/productId để hệ thống biết key test thuộc tool nào.
B2 - Tạo TST key
Sau khi đã có sản phẩm draft, seller vào khu vực Test License để tạo TST key và staging client credentials cho sản phẩm đó.
B3 - Đưa cho AI/dev test
Đưa TST key, staging Client ID/Secret và docs này cho AI hoặc developer để build phần activate/verify trong app.
B4 - Test bằng staging
Trong lúc test chỉ dùng TST key với staging credentials. App cần gọi /licenses/activate một lần, rồi /licenses/verify trước khi mở tính năng khóa.
B5 - Xin production key
Khi app đã test ổn, seller liên hệ admin để xin production key/production credentials. Production không dùng TST key.
Ghi chú bắt buộc cho seller
Seller phải có sản phẩm draft trước thì mới tạo được test license cho tool đó. Sau khi test app bằng TST key thành công, seller cần liên hệ admin để được cấp production key/production credentials trước khi build hoặc release bản production.
Mục này chỉ chứa endpoint runtime mà partner tool cần gọi để activate và verify license.
Runtime unlock endpoints
/licenses/activateLần đầu tool cần kiểm tra key trên thiết bị mới. Dùng để “gắn” license vào device fingerprint.
Runtime unlock/licenses/verifyKiểm tra key có hợp lệ cho thiết bị hiện tại trước khi mở tính năng premium/protected.
Runtime unlockGhi chú nhanh
- Header bắt buộc: `X-Product-Client-Id`, `X-Product-Client-Secret`.
- Dùng staging credentials với TST key; dùng production credentials với license thật.
- Endpoint runtime partner chỉ cần `/licenses/activate` và `/licenses/verify`.