Produkt und Lizenz API
Stellen Sie nach einer Bestellung Lizenzen von Ihrem eigenen Server aus: Erstellen Sie das Produkt und die Richtlinie und anschließend eine Lizenz für jeden Kunden. Normalerweise werden Produkt und Richtlinie einmal konfiguriert.
Erstellen Sie zunächst eine schreibfähige Datei Management API Schlüssel. Die folgenden Beispiele verwenden Authorization: Bearer YOUR_MANAGEMENT_API_KEY; Bewahren Sie diesen Schlüssel auf dem Server des Anbieters auf.
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.
Geben Sie bei der Ausstellung einer Lizenz Gültigkeitstage ein: 1–36500 für Zeit- und Testlizenzen und keine für unbefristete Lizenzen. Richtlinien speichern keine Gültigkeitstage.
Verwenden Sie data.id aus der Produktantwort als product_id und data.id aus der Richtlinienantwort als policy_id. Speichern Sie nach der Lizenzausstellung data.id und data.key.
Sie können den vollständigen Schlüssel jederzeit in der Lizenzliste anzeigen und kopieren. Geben Sie ihn nur an den zugehörigen Kunden weiter.
Für eine zeitlich begrenzte Lizenz vor der Aktivierung,expires_at und first_activated_at sind null. Die Laufzeit beginnt mit der ersten erfolgreichen Freischaltung; Die Übertragung gewährt keine neue Amtszeit.
Weitere Geschäftsführung
| Methode und Pfad (ohne /api/v1) | Zweck und Anforderungsorgan |
|---|---|
GET /products | Produkte auflisten. In der Antwort ist data.items das Datensatzarray und data.total die Gesamtzahl. |
GET /licenses/{id} | Lesen Sie Lizenzdetails, Erstaktivierung und Ablauf. |
POST /licenses/{id}/renew | Erneuern, z.B. {"Tage":30}. Behält die Originallizenz. |
POST /licenses/{id}/revoke | Widerrufen; Der Anfragetext ist {}. |
GET /products/{id}/public-keys | Lesen Sie die öffentlichen Schlüssel des Produkts ohne Authentifizierung. Pin vertrauenswürdige Schlüssel beim Verteilen der SDK. |
GET /activations | Gerätebindungen und Laufzeitsitzungen anzeigen. |
Verwendung der Listenpaginierung limit=25&offset=0, der Grenzwert liegt bei höchstens 100. Weitere Parameter und Schemata sind in enthalten OpenAPI-Datei; Für jedes Lizenzmodell finden Sie das entsprechende Thema auf der linken Seite.
Wie rufe ich mit einer Browser-Anmeldesitzung an?
Für das Schreiben mithilfe von Browser-Cookies ist ein X-CSRF-Token erforderlich. Zuerst GET /api/v1/auth/csrf, dann data.csrf_token in diesen Header einfügen. Inhaberschlüsselanfragen erfordern nicht CSRF.