Vai al contenuto

Token API e licenza sandbox

79 visualizzazioni · Aggiornato Nov 22, 2026

Gli autori hanno a disposizione due strumenti per integrare i controlli di licenza in un prodotto: i token API, che autenticano le richieste all'API di AppTrovo a nome del tuo account, e le licenze di test sviluppatore gratuite, che ti permettono di eseguire l'intero flusso di verifica della licenza sul tuo computer prima che qualsiasi acquirente abbia una chiave.

Token API

Quando ti serve un token

L'endpoint di verifica delle licenze (/api/v1/licenses/verify) è pubblico. Il tuo prodotto non ha bisogno di un token per controllare la chiave di un acquirente. I token servono per le parti autenticate dell'API, come l'elenco delle licenze possedute dal tuo account (/api/v1/licenses) o la lettura dei tuoi dati di autore in /api/v2/author/.

Un token agisce a nome del tuo account. Non inserire mai un token in un prodotto che vendi, in un repository pubblico o nel codice lato client. Chiunque lo possieda può effettuare chiamate API al posto tuo.

Creare un token

  1. Vai a /author/api-tokens dopo aver effettuato l'accesso al tuo account autore.
  2. In Crea nuovo token, inserisci un Nome token che indichi dove verrà usato il token, ad esempio "Server di build".
  3. Fai clic su Crea token.
  4. Copia subito il token dal riquadro verde: non verrà mostrato di nuovo. Fai clic su Ignora dopo averlo conservato in un luogo sicuro.
Pagina Token API con un campo Nome token e un pulsante Crea token, una sezione I tuoi token con la scritta Nessun token API creato e un riquadro Utilizzo API con un esempio di richiesta di verifica e le relative intestazioni
La pagina Token API nel Pannello autore.

Invia il token nell'intestazione Authorization: Bearer , insieme a Accept: application/json.

Gestire e revocare i token

I tuoi token elenca ogni token con il nome, la data di creazione e quella dell'ultimo utilizzo, oppure "Mai usato". Puoi avere fino a 10 token contemporaneamente. I token non scadono da soli, quindi revoca quelli che non ti servono più: fai clic su Revoca e conferma. Un token revocato smette di funzionare immediatamente. Se un token potrebbe essere stato divulgato, revocalo e creane uno nuovo.

La licenza sandbox dell'SDK

La sandbox ti permette di provare la verifica delle licenze prima ancora di aver creato un prodotto. Ti fornisce una chiave sviluppatore per un prodotto sandbox condiviso il cui slug è apptrovo-sdk-sandbox.

  1. Apri /author/sandbox-license. Se non hai ancora prodotti, anche il pannello di controllo dell'autore mostra un pulsante Ottieni licenza sandbox.
  2. Fai clic su Genera. La chiave compare con un pulsante di copia, la data di scadenza, gli slot di dominio in uso e lo slug del prodotto.
  3. Copia i comandi dello Smoke test rapido mostrati sotto la chiave. Il primo, con domain=localhost, deve restituire "valid": true. Il secondo, con un dominio pubblico, deve essere rifiutato.
  4. Configura il tuo installer con lo slug della sandbox ed esegui i tuoi scenari di verifica.
Pagina Licenza sandbox SDK con una scheda della licenza sviluppatore sandbox che elenca i domini locali consentiti e un pulsante Genera, seguita da un avviso giallo su cosa fare quando pubblichi il tuo prodotto e un link per tornare alla Guida all'integrazione delle licenze
Genera una chiave sandbox dalla pagina Licenza sandbox SDK.

Licenze sviluppatore per i tuoi prodotti

Quando hai un prodotto, esegui i test direttamente su di esso:

  1. Apri I miei prodotti e fai clic sul prodotto per aprirne la pagina di dettaglio.
  2. Trova la scheda Licenza di test sviluppatore e fai clic su Genera.
  3. Copia la chiave e lo slug del prodotto dalla scheda, poi usa il comando del Test rapido per verificare che funzioni.

Al momento della pubblicazione, sostituisci nella configurazione del tuo installer lo slug della sandbox con lo slug reale del prodotto. Il resto dell'integrazione rimane invariato.

Regole delle licenze sviluppatore

Le licenze sandbox e quelle sviluppatore per singolo prodotto funzionano allo stesso modo:

  • Vengono verificate solo su hostname locali: localhost, 127.0.0.1, ::1 e i nomi che terminano con .test, .local o .localhost. Un dominio reale viene rifiutato, quindi la chiave non può essere usata in produzione.
  • Ogni controllo deve includere il parametro domain.
  • Ogni chiave ha 5 slot di dominio ed è valida per 30 giorni. Fai clic su Estendi di 30 giorni nella stessa scheda per posticipare la scadenza. La chiave resta la stessa.
  • Hai una sola licenza sviluppatore per prodotto. Generarla di nuovo estende la chiave esistente invece di crearne una nuova.
  • La risposta della verifica riporta "license_type": "developer" e "is_dev": true, così il tuo codice può distinguere le chiavi di test.

Domande frequenti

Perché non vedo Token API nella barra laterale?

Al momento la pagina non ha una voce di menu. Aggiungi /author/api-tokens ai preferiti.

La mia chiave sviluppatore indica "License has expired"

Apri la scheda in cui l'hai creata e fai clic su Estendi di 30 giorni. La stessa chiave riprende a funzionare.

Articoli correlati

Questo articolo è stato utile?