Mục lục thư viện
Thư viện tài liệuBắt đầu
Giao phần mềm cho khách
Khi phần mềm đã qua [danh sách thử](/docs/before-selling), còn ba việc: đưa bản build tới khách, đưa key tới khách, và giúp khách khi họ vướng. Bài này gom ba việc đó, mỗi phần trỏ tới bài chi tiết.
3 phút đọc
1. Bản build
- Bản build mang địa chỉ API, App ID và khoá công khai của ứng dụng. Khoá công khai chỉ kiểm chữ ký nên nhúng vào là an toàn; đừng bao giờ nhúng một khoá bí mật nào.
- Khai báo đúng phiên bản (
appVersionhay tên tương ứng trong SDK của bạn): server dùng nó để chặn bản quá cũ và báo có bản mới. - Phát hành qua ClavisAUH để có bản có ký, link tải hết hạn sau 5 phút và phần mềm tự kiểm cập nhật: Bản phát hành có ký và cập nhật. Bạn vẫn có thể phát hành qua kênh riêng của mình.
- Trước khi đổi khoá ký, phát hành một bản build mang cả khoá cũ lẫn khoá mới: Khoá ký và xoay vòng khoá.
2. Đưa key tới khách
| Cách | Hợp với | Đọc thêm |
|---|---|---|
| Tạo key trong dashboard rồi gửi cho khách | Bán ít, bán trực tiếp | Tạo và quản lý license |
| Cửa hàng của bạn gọi Seller API khi có đơn hàng | Bán online, tự động | Bán hàng qua Seller API |
| Đại lý tạo key bằng tín dụng bạn cấp | Bán qua kênh phân phối | Đại lý và tín dụng |
Dù cách nào:
- Key đầy đủ chỉ hiện một lần, lúc tạo. ClavisAUH chỉ giữ mã băm, nên hãy gửi hoặc lưu ngay.
- Gắn email người mua vào license: người mua đăng nhập được cổng khách hàng và nhận thư nhắc trước khi hết hạn.
- Muốn hệ thống của bạn biết khi key được kích hoạt hay sắp hết hạn, đăng ký Webhook.
3. Khách tự phục vụ
Bật cổng khách hàng cho ứng dụng: người mua đăng nhập bằng email hoặc bằng key, xem license của mình, và tự gỡ máy cũ theo luật chuyển máy bạn đặt (Thiết bị, HWID và chuyển máy). Phần lớn yêu cầu "đổi máy" không cần tới bạn nữa.
4. Khi khách báo không vào được
- Dán key của khách vào ô tìm (phím tắt ⌘K hoặc Ctrl K): dashboard mở đúng license của key đó.
- Trong ngăn chi tiết, mục Lượt gọi SDK gần đây ghi các lượt gọi gần nhất, lượt bị từ chối kèm lý do. Toàn bộ ở Nhật ký hoạt động.
- Xử lý theo lý do:
| Lý do | Thường là | Bạn làm |
|---|---|---|
invalid_credentials | Key gõ sai, thuộc ứng dụng khác, hoặc không còn dùng được trên máy chưa có suất | Kiểm key và ứng dụng; xem trạng thái license |
device_limit | Khách đổi máy hay cài trên máy thứ hai | Đặt lại thiết bị, hoặc để khách tự gỡ máy cũ trong cổng khách hàng |
license_expired | Hết hạn | Gia hạn |
license_suspended | Bạn đã tạm khoá | Mở khoá nếu hợp lệ |
update_required | Bản của khách thấp hơn phiên bản tối thiểu | Gửi bản mới |
network_error, timeout | Mạng, tường lửa hay proxy bên khách | Nhờ khách mở kết nối tới địa chỉ API của bạn |
Câu báo lỗi khách thấy trên màn hình là câu của mã đó trong bảng Mã lỗi, nên khách đọc cho bạn câu nào thì bạn biết ngay mã nào.