Panduan penyiapan API
Subdomain manajemen lisensi memudahkan pengelolaan lisensi, memungkinkan Anda mengunggah file lisensi baru, mengambil informasi tentang lisensi aktif saat ini, dan menghapus lisensi yang ada.
Untuk mendapatkan lisensi yang valid, silakan hubungi kami.
Penyiapan API manajemen lisensi
1. Mengunggah lisensi aktif
API dapat diakses melalui titik masuk Glasswall Halo. Titik masuk ini menggunakan alamat IP/URL yang sama dengan portal.
Untuk mengirim file lisensi, kirim permintaan post ke endpoint /API/v1/license. Sertakan body permintaan json yang berisi file lisensi dalam format .lic.
-----BEGIN LICENSE FILE-----\n eyJlbmMiOiJleUprWVhSaElqcDdJbWxrSWpvaU1EYzFZV05sT1RFdFlUaGtP\n UzAwTVdObUxXRmtNMk10TTJJd01EWXpOakF5WTJRMUlpd2lkSGx3WlNJNklt\n...\nYithdmN6WmVTMitrZGxrKzNwZ0RGTXhueHVpWkNYQUI3RlRrYnB5MkRRPT0i\nLCJhbGciOiJiYXNlNjQrZWQyNTUxOSJ9\n-----END LICENSE FILE-----\n
Dengan asumsi lisensi valid dan masih dalam masa berlakunya, API akan merespons dengan body JSON yang berisi detail lisensi, yang memberikan ringkasan struktur file lisensi. Anda dapat menemukan informasi lebih lanjut tentang detail lisensi di sini.
Catatan: harap diperhatikan bahwa hanya satu lisensi aktif yang diizinkan pada satu waktu.
Respons yang tidak berhasil dari license API biasanya menunjukkan lisensi yang tidak valid atau kedaluwarsa. Body respons akan menyertakan pesan kesalahan yang menjelaskan alasan lisensi gagal lolos pemeriksaan validasi. Jika Anda mengalami situasi ini, silakan hubungi kami, dan tim kami akan membantu Anda memperoleh file lisensi yang valid agar dapat mencoba proses ini kembali dengan berhasil.
2. Memverifikasi lisensi yang benar telah diinstal
Setelah mengunggah lisensi aktif Anda, respons akan berisi detail lisensi. Untuk mengambil kembali detail lisensi ini, kirim permintaan get ke /API/v1/license menggunakan entry point yang sama seperti yang disebutkan pada Langkah 1. Anda dapat menemukan informasi lebih lanjut tentang detail lisensi di sini.
Untuk memastikan kebenaran lisensi, harap verifikasi detail lisensi. Secara khusus, pastikan bahwa daysleft, startdate, dan entitlements sesuai dengan yang Anda harapkan untuk lisensi yang dibeli. Jika Anda menduga bahwa lisensi yang diberikan tidak valid atau mengandung ketidakakuratan, silakan hubungi kami.
Silakan juga merujuk ke dokumentasi API kami untuk informasi lebih lanjut.
Memperbarui lisensi aktif
Untuk memperbarui lisensi, cukup ikuti langkah-langkah yang sama seperti yang disebutkan sebelumnya untuk menginstal lisensi baru. Mengunggah lisensi baru akan secara otomatis menggantikan lisensi sebelumnya, memastikan bahwa lisensi baru tersebut berlaku.
Harap tunggu 60 detik agar lisensi baru berlaku.
Menghapus lisensi aktif
Untuk menghapus lisensi yang saat ini aktif, kirim permintaan delete ke /API/v1/license menggunakan entry point yang sama dari langkah-langkah sebelumnya. Tindakan ini akan menghapus lisensi dan tidak dapat dibatalkan.