API di licenza software: attivazione, verifica e heartbeat

Scegli una lingua e un'operazione, quindi chiama il numero SDK. Gestisce l'attivazione, l'identità del dispositivo, la verifica della firma, la cache, gli heartbeat e la riserva misurata, il commit e l'annullamento.

Schermata di avvio o attivazionePrima delle funzionalità a pagamentoAll'uscita dall'applicazione

Common scenario snippets

In questi esempi, il client proviene dall'avvio, il percorso è il percorso di esportazione e l'exportReport / export_report è la funzione aziendale. JobID misurato è l'ID stabile mantenuto dalla tua applicazione.

Vedi il codice completo → · Avvio rapido · Vedi integrazione misurata e tentativi →

Inserisci il codice aziendale nella callback.

Lo SDK svolge attività solo quando consentito. RunFeature non detrae l'utilizzo; RunMeteredFeature effettua riserve, esegue il commit dopo il successo e annulla dopo il fallimento. Riprovare il lavoro originale per confermare la conferma senza ripetere l'attività completata.

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.

Espandi HTTP richieste e risposte (client personalizzati o risoluzione dei problemi)

Il protocollo seguente è implementato dagli SDK. Le applicazioni che utilizzano questi nove SDK non devono implementarlo nuovamente.

Prima attivazioneBattito cardiaco in fase di esecuzioneControllare l'accesso prima delle operazioni aziendaliDisattiva prima del trasferimento del dispositivo

Questi otto endpoint autenticano la licenza e l'identità del dispositivo, senza cookie di accesso, CSRF o chiavi di gestione del fornitore. Rilascio delle sessioni mobili all'uscita; i dispositivi con nodo bloccato mantengono la registrazione.

Come posso verificare l'accesso dopo l'attivazione, la convalida o un heartbeat?

Controlla HTTP 200 e leggi data.activation_id. Includere questo ID nelle richieste successive di convalida, heartbeat, misurazione e disattivazione.
Verificare con la chiave pubblica del prodotto pre-attendibile data.lease firma, quindi verificare il prodotto, il dispositivo, la validità e le caratteristiche. La sola decodifica del payload in JSON non dimostra che una licenza è valida.
Con lo SDK i primi due passaggi sono automatici. RunFeature controlla l'accesso prima dell'inizio dell'attività; RunMeteredFeature gestisce la prenotazione, la conferma e l'annullamento dei contatori.

SDK memorizza le cache firmate e invia heartbeat basati su policy. Non cancellare una cache valida solo perché una richiesta scade. Per revoca, rilascio o scadenza esplicita, utilizzare il risultato SDK per bloccare le funzionalità protette.

Cosa significano i campi del payload decodificato?

L'esempio seguente spiega solo i dati. Se si implementa la verifica della firma, utilizzare i byte originali del payload ricevuto; non riordinare o serializzare JSON prima di verificare.

Nuovi tentativi, heartbeat e fatturazione

Necessario per l'attivazione, la disattivazione e la misurazione delle funzionalità Idempotency-Key, fino a 80 caratteri senza spazi. Generare un nuovo valore per ogni operazione; mantenere lo stesso valore e lo stesso corpo quando si riprova. Facoltativo per convalida e heartbeat; lo SDK gestisce i propri ID di richiesta.

Finché l’autorizzazione resta valida, le stesse richieste di convalida e heartbeat possono essere ritentate per un’ora senza addebiti duplicati. Dopo tale intervallo, usa una nuova chiave di richiesta; una vecchia chiave può essere trattata come una nuova richiesta. Attivazione, disattivazione e consumo delle funzionalità mantengono registrazioni durature di idempotenza.

Ogni attivazione, convalida, heartbeat o disassociazione riuscita utilizza una chiamata API della piattaforma. I fallimenti e i replay idempotenti non vengono conteggiati nuovamente; local CheckFeature non effettua alcuna richiesta. Il consumo deduce solo gli utilizzi delle funzionalità software, non la quota API di questa piattaforma. la quantità è il numero di utilizzi delle funzionalità consumati.

Intervallo di heartbeat, durata offline e follow offline permanente Politiche di licenzaimpostazioni.payload.expires_at è la scadenza della cache firmata corrente, non la scadenza finale della licenza. Controlla i dettagli della licenza per quest'ultimo.