Softwarelizenz-API: Aktivierung, Prüfung und Heartbeats
Wählen Sie eine Sprache und einen Vorgang aus und rufen Sie dann SDK an. Es kümmert sich um Aktivierung, Geräteidentität, Signaturüberprüfung, Cache, Heartbeats und gemessene Reserve, Festschreibung und Stornierung.
Common scenario snippets
In diesen Beispielen stammt der Client vom Startup, path ist Ihr Exportpfad und exportReport / export_report ist Ihre Geschäftsfunktion. Die gemessene Job-ID ist die stabile ID, die von Ihrer Anwendung beibehalten wird.
Siehe den vollständigen Code → · Schnellstart · Siehe gemessene Integration und Wiederholungsversuche →
Das SDK führt Geschäfte nur dann durch, wenn dies zulässig ist. RunFeature zieht die Nutzung nicht ab; RunMeteredFeature reserviert, schreibt nach Erfolg fest und bricht nach einem Fehler ab. Wiederholen Sie den ursprünglichen Auftrag, um die Bestätigung abzuwickeln, ohne den abgeschlossenen Auftrag zu wiederholen.
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.
Erweitern Sie HTTP Anfragen und Antworten (benutzerdefinierte Clients oder Fehlerbehebung)
Das folgende Protokoll wird von den SDKs implementiert. Anwendungen, die diese neun SDKs verwenden, müssen sie nicht erneut implementieren.
Diese acht Endpunkte authentifizieren Lizenz- und Geräteidentität, ohne Anmeldecookies, CSRF oder Anbieterverwaltungsschlüssel. Floating-Sitzungen werden beim Beenden freigegeben; Knotengebundene Geräte behalten die Registrierung bei.
Wie überprüfe ich den Zugriff nach der Aktivierung, Validierung oder einem Heartbeat?
- Suchen Sie nach HTTP 200 und lesen Sie
data.activation_id. Beziehen Sie diese ID in spätere Validierungs-, Heartbeat-, Mess- und Deaktivierungsanfragen ein. - Überprüfen Sie mit dem vorab vertrauenswürdigen öffentlichen Schlüssel des Produkts
data.leaseSignatur, dann überprüfen Sie das Produkt, das Gerät, die Gültigkeit und die Funktionen. Die Dekodierung der Nutzdaten in JSON allein beweist nicht, dass eine Lizenz gültig ist. - Bei der SDK erfolgen die ersten beiden Schritte automatisch. RunFeature prüft den Zugriff vor dem Geschäft; RunMeteredFeature verwaltet die Reservierung, Bestätigung und Stornierung von Zählern.
Das SDK speichert signierte Caches und sendet richtlinienbasierte Heartbeats. Löschen Sie keinen gültigen Cache, nur weil bei einer Anfrage das Zeitlimit überschritten wird. Für einen expliziten Widerruf, eine Freigabe oder einen Ablauf verwenden Sie das Ergebnis SDK, um geschützte Funktionen zu blockieren.
Was bedeuten entschlüsselte Nutzdatenfelder?
Das folgende Beispiel erläutert nur die Daten. Wenn Sie eine Signaturüberprüfung implementieren, verwenden Sie die Originalbytes der empfangenen Nutzdaten. Bestellen oder serialisieren Sie die Nummer JSON nicht vor der Überprüfung neu.
Wiederholungsversuche, Heartbeats und Abrechnung
Erforderlich für Aktivierung, Deaktivierung und Funktionsmessung Idempotency-Key, bis zu 80 Zeichen ohne Leerzeichen. Generieren Sie für jede Operation einen neuen Wert. Behalten Sie den gleichen Wert und Text bei, wenn Sie es erneut versuchen. Optional für Validierung und Heartbeats; Das SDK verarbeitet ihre eigenen Anforderungs-IDs.
Solange die Autorisierung gültig bleibt, können identische Validierungs- und Heartbeat-Anfragen eine Stunde lang ohne doppelte Abrechnung wiederholt werden. Verwenden Sie danach einen neuen Anfrageschlüssel; ein alter Schlüssel kann als neue Anfrage behandelt werden. Aktivierung, Deaktivierung und Funktionsverbrauch behalten dauerhafte Idempotenzdatensätze.
Für jede erfolgreiche Aktivierung, Validierung, jeden Heartbeat oder jede erfolgreiche Entbindung wird ein Plattformaufruf API verwendet. Ausfälle und idempotente Wiederholungen werden nicht erneut gezählt; Das lokale CheckFeature stellt keine Anfrage. Durch den Verbrauch werden nur Softwarefunktionsnutzungen abgezogen, nicht das API-Kontingent dieser Plattform. Bei der Menge handelt es sich um die Anzahl der genutzten Funktionsnutzungen.
Heartbeat-Intervall, Offline-Dauer und permanente Offline-Verfolgung LizenzrichtlinienEinstellungen.payload.expires_at ist der Ablauf des aktuell signierten Caches, nicht der endgültige Ablauf der Lizenz. Überprüfen Sie die Lizenzdetails für Letzteres.