Prodotto e licenza API
Emetti le licenze dal tuo server dopo un ordine: crea il prodotto e la policy, quindi una licenza per ciascun cliente. Di solito il prodotto e la policy vengono configurati una volta.
Per prima cosa crea un file abilitato alla scrittura Chiave di gestione API. Gli esempi seguenti utilizzano Authorization: Bearer YOUR_MANAGEMENT_API_KEY; mantenere questa chiave sul server del fornitore.
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.
Inserisci i giorni di validità al momento del rilascio di una licenza: 1–36500 per le licenze a tempo e di prova e nessuno per le licenze permanenti. Le policy non memorizzano i giorni di validità.
Usa data.id della risposta del prodotto come product_id e data.id della risposta della politica come policy_id. Dopo aver emesso una licenza, salva data.id e data.key.
Puoi visualizzare e copiare di nuovo la chiave completa dall’elenco delle licenze. Condividila solo con il cliente corrispondente.
Per una licenza a tempo prima dell'attivazione,expires_at e first_activated_at sono nulli. Il termine decorre dalla prima attivazione avvenuta con successo; il trasferimento non conferisce un nuovo termine.
Ulteriore gestione
| Metodo e percorso (senza /api/v1) | Scopo ed ente della richiesta |
|---|---|
GET /products | Elenca i prodotti. Nella risposta, data.items è l'array di record e data.total è il conteggio totale. |
GET /licenses/{id} | Leggi i dettagli della licenza, prima attivazione e scadenza. |
POST /licenses/{id}/renew | Rinnovare, ad es. {"giorni":30}. Mantiene la licenza originale. |
POST /licenses/{id}/revoke | Revoca; il corpo della richiesta è {}. |
GET /products/{id}/public-keys | Leggere le chiavi pubbliche del prodotto senza autenticazione. Blocca le chiavi attendibili durante la distribuzione del file SDK. |
GET /activations | Visualizza i collegamenti dei dispositivi e le sessioni di runtime. |
Elenco usi dell'impaginazione limit=25&offset=0, il limite è al massimo 100. Sono presenti altri parametri e schemi File OpenAPI; vedere l'argomento pertinente a sinistra per ciascun modello di licenza.
Come posso chiamare con una sessione di accesso al browser?
La scrittura utilizzando i cookie del browser richiede X-CSRF-Token. Prima GET /api/v1/auth/csrf, quindi inserisci data.csrf_token in quell'intestazione. Le richieste di chiave al portatore non richiedono CSRF.