API des produits et licences
Après une commande, émettez les licences depuis votre serveur : créez le produit et la stratégie, puis une licence par client. Les deux premiers éléments se configurent généralement une seule fois.
Créez d’abord dans la console un Clé API de gestion. Les exemples suivants utilisent Authorization: Bearer YOUR_MANAGEMENT_API_KEY ; gardez cette clé sur le serveur du fournisseur.
The examples above show the minimum issuance flow. For queries, updates, archiving, renewals, devices, usage, offline licensing and events, see “All management requests and responses” under Management API Key.
Saisissez les jours à l’émission : 1–36500 pour les licences temporaires et d’essai, aucun pour les licences perpétuelles. Les politiques ne stockent pas cette durée.
Utilisez data.id de la réponse produit comme product_id et data.id de la réponse de politique comme policy_id. Après l’émission d’une licence, enregistrez data.id et data.key.
Vous pouvez consulter et copier à nouveau la clé complète dans la liste des licences. Partagez-la uniquement avec le client concerné.
Pour une licence limitée avant activation,expires_at et first_activated_at sont null. Durée à partir de la première activation ; le transfert ne la recommence pas.
Gestion ultérieure
| Méthode et chemin (sans /api/v1) | Utilité et corps de requête |
|---|---|
GET /products | Liste les produits. Dans la réponse, data.items est le tableau des enregistrements et data.total leur nombre total. |
GET /licenses/{id} | Consulter licence, première activation et échéance. |
POST /licenses/{id}/renew | Renouveler, p. ex. {"days":30}. Conserve la licence d’origine. |
POST /licenses/{id}/revoke | Révoquer ; corps {}. |
GET /products/{id}/public-keys | Lire les clés publiques sans authentification. Fixez les clés de confiance à la distribution du SDK. |
GET /activations | Voir les liens d’appareils et sessions. |
La pagination utilise limit=25&offset=0, limit vaut au plus 100. Autres paramètres et structures : Fichier OpenAPI ; consultez le sujet à gauche correspondant au modèle.
Comment appeler avec une session de navigateur ?
Les écritures avec cookie exigent X-CSRF-Token. Faites GET /api/v1/auth/csrf, puis placez data.csrf_token dans cet en-tête. Les requêtes Bearer Key n’exigent pas de CSRF.