API lisensi perangkat lunak: aktivasi, validasi, dan heartbeat

Pilih bahasa dan operasi, lalu panggil SDK. SDK menangani aktivasi, identitas perangkat, verifikasi tanda tangan, cache, heartbeat serta reservasi, konfirmasi dan pembatalan penggunaan.

Mulai atau layar aktivasiSebelum fitur berbayarSaat aplikasi keluar

Common scenario snippets

Dalam contoh, client berasal dari startup, path adalah jalur ekspor dan exportReport / export_report adalah fungsi bisnis Anda. jobID terukur adalah ID tetap yang disimpan aplikasi.

Lihat kode lengkap → · Mulai cepat · Lihat integrasi terukur dan percobaan ulang →

Letakkan kode bisnis di callback.

SDK menjalankan bisnis hanya jika diizinkan. RunFeature tidak mengurangi kuota; RunMeteredFeature mereservasi, mengonfirmasi keberhasilan dan membatalkan kegagalan. Ulangi tugas asli untuk konfirmasi tanpa mengulang bisnis yang selesai.

Complete SDK method reference

The scenarios above are short call snippets. Below are the current language’s public methods, properties and utilities, including full signatures, parameters, results, errors, configuration and data fields. The reference follows the selected language and identifies capabilities that are unavailable in a wrapper.

Buka permintaan dan respons HTTP (klien khusus atau pemecahan masalah)

Protokol di bawah sudah diterapkan oleh SDK. Aplikasi yang memakai sembilan SDK ini tidak perlu menerapkannya lagi.

Aktivasi pertamaHeartbeat saat berjalanPeriksa akses sebelum operasi bisnisLepaskan sebelum pindah perangkat

Delapan endpoint memakai lisensi dan identitas perangkat, tanpa cookie login, CSRF, atau kunci vendor. Sesi floating dilepas saat keluar; perangkat terikat tetap terdaftar.

Bagaimana memeriksa akses setelah aktivasi, validasi atau heartbeat?

Pastikan HTTP 200 lalu baca data.activation_id. Sertakan ID ini pada validasi, heartbeat, penghitungan dan pelepasan berikutnya.
Verifikasi dengan kunci publik produk yang dipercaya sebelumnya data.lease lalu cocokkan produk, perangkat, masa berlaku, dan fitur. Membaca payload sebagai JSON saja tidak membuktikan lisensi sah.
SDK otomatis menangani dua langkah pertama. RunFeature memeriksa izin sebelum operasi; RunMeteredFeature mengelola reservasi, konfirmasi, dan pembatalan penghitung.

SDK menyimpan cache bertanda tangan dan heartbeat sesuai kebijakan. Jangan hapus cache sah hanya karena timeout. Jika jelas dicabut, dilepas, atau kedaluwarsa, blokir fitur terlindungi sesuai hasil SDK.

Apa arti kolom payload setelah dekode?

Contoh berikut hanya untuk memahami data. Untuk verifikasi tanda tangan sendiri, gunakan byte payload asli yang diterima; jangan urutkan ulang atau serialisasikan JSON.

Percobaan ulang, heartbeat dan tagihan

Wajib untuk aktivasi, pelepasan dan penghitungan Idempotency-Key, maksimal 80 karakter tanpa spasi. Operasi baru memakai nilai baru; percobaan ulang mempertahankan nilai dan isi yang sama. Opsional untuk validasi dan heartbeat; SDK mengelola ID permintaannya.

Selama otorisasi masih berlaku, permintaan validasi dan heartbeat yang sama dapat dicoba ulang selama satu jam tanpa tagihan ganda. Setelah itu, gunakan kunci permintaan baru; kunci lama dapat dianggap sebagai permintaan baru. Aktivasi, deaktivasi, dan penggunaan fitur tetap menyimpan catatan idempotensi permanen.

Tiap aktivasi, validasi, heartbeat, atau pelepasan berhasil memakai satu panggilan API platform. Gagal dan ulang idempoten tidak dihitung lagi; CheckFeature lokal tanpa server. Consume hanya mengurangi pemakaian fitur, bukan kuota API ini; quantity adalah jumlah pemakaian fitur.

Interval, durasi offline dan permanen mengikuti Kebijakan lisensi.payload.expires_at adalah waktu habis cache bertanda tangan saat ini, bukan akhir lisensi. Lihat detail lisensi untuk tanggal akhirnya.