Chuyển đến nội dung chính

Hướng dẫn thiết lập API

Tên miền phụ quản lý giấy phép giúp việc quản lý giấy phép trở nên dễ dàng, cho phép bạn tải lên các tệp giấy phép mới, truy xuất thông tin về giấy phép đang hoạt động hiện tại và xóa giấy phép hiện có.

Để có được giấy phép hợp lệ, vui lòng liên hệ với chúng tôi.


Thiết lập API quản lý giấy phép

1. Tải lên giấy phép đang hoạt động

Có thể truy cập API thông qua điểm vào của Glasswall Halo. Điểm vào này dùng chung cùng địa chỉ IP/URL với cổng thông tin.

Để gửi tệp giấy phép, hãy gửi một yêu cầu post tới endpoint /API/v1/license. Bao gồm phần thân yêu cầu json chứa tệp giấy phép ở định dạng .lic.

-----BEGIN LICENSE FILE-----\n  eyJlbmMiOiJleUprWVhSaElqcDdJbWxrSWpvaU1EYzFZV05sT1RFdFlUaGtP\n  UzAwTVdObUxXRmtNMk10TTJJd01EWXpOakF5WTJRMUlpd2lkSGx3WlNJNklt\n...\nYithdmN6WmVTMitrZGxrKzNwZ0RGTXhueHVpWkNYQUI3RlRrYnB5MkRRPT0i\nLCJhbGciOiJiYXNlNjQrZWQyNTUxOSJ9\n-----END LICENSE FILE-----\n

Giả sử giấy phép hợp lệ và vẫn còn trong thời hạn hiệu lực, API sẽ phản hồi với phần thân JSON chứa thông tin chi tiết về giấy phép, cung cấp bản tóm tắt cấu trúc của tệp giấy phép. Bạn có thể tìm thêm thông tin về chi tiết giấy phép tại đây.

Lưu ý: vui lòng lưu ý rằng tại một thời điểm bất kỳ chỉ được phép có một giấy phép đang hoạt động.

Phản hồi không thành công từ license API thường cho biết giấy phép không hợp lệ hoặc đã hết hạn. Phần thân phản hồi sẽ bao gồm thông báo lỗi nêu rõ lý do giấy phép không vượt qua các bước kiểm tra xác thực. Nếu bạn gặp tình huống này, vui lòng liên hệ với chúng tôi và đội ngũ của chúng tôi sẽ hỗ trợ bạn lấy tệp giấy phép hợp lệ để thử lại quy trình thành công.

2. Xác minh đúng giấy phép đã được cài đặt

Sau khi tải lên giấy phép đang hoạt động của bạn, phản hồi sẽ chứa thông tin chi tiết về giấy phép. Để truy xuất lại các thông tin chi tiết này, hãy gửi yêu cầu get tới /API/v1/license bằng cùng điểm vào đã đề cập ở Bước 1. Bạn có thể tìm thêm thông tin về chi tiết giấy phép tại đây.

Để đảm bảo tính chính xác của giấy phép, vui lòng xác minh thông tin chi tiết của giấy phép. Cụ thể, hãy xác nhận rằng daysleft, startdateentitlements phù hợp với kỳ vọng của bạn đối với giấy phép đã mua. Nếu bạn nghi ngờ giấy phép được cung cấp không hợp lệ hoặc có thông tin không chính xác, vui lòng liên hệ với chúng tôi.

Vui lòng cũng tham khảo tài liệu API của chúng tôi để biết thêm thông tin.

Cập nhật giấy phép đang hoạt động

Để cập nhật giấy phép, chỉ cần làm theo các bước tương tự như đã nêu trước đó để cài đặt giấy phép mới. Việc tải lên giấy phép mới sẽ tự động thay thế giấy phép trước đó, đảm bảo giấy phép mới có hiệu lực.

Vui lòng chờ 60 giây để giấy phép mới có hiệu lực.

Xóa giấy phép đang hoạt động

Để xóa giấy phép hiện đang hoạt động, hãy gửi yêu cầu delete tới /API/v1/license bằng cùng điểm vào từ các bước trước. Hành động này sẽ xóa giấy phép và không thể hoàn tác.