Token API e licenza sandbox
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
- Vai a /author/api-tokens dopo aver effettuato l'accesso al tuo account autore.
- In Crea nuovo token, inserisci un Nome token che indichi dove verrà usato il token, ad esempio "Server di build".
- Fai clic su Crea token.
- Copia subito il token dal riquadro verde: non verrà mostrato di nuovo. Fai clic su Ignora dopo averlo conservato in un luogo sicuro.

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.
- Apri /author/sandbox-license. Se non hai ancora prodotti, anche il pannello di controllo dell'autore mostra un pulsante Ottieni licenza sandbox.
- 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.
- 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. - Configura il tuo installer con lo slug della sandbox ed esegui i tuoi scenari di verifica.

Licenze sviluppatore per i tuoi prodotti
Quando hai un prodotto, esegui i test direttamente su di esso:
- Apri I miei prodotti e fai clic sul prodotto per aprirne la pagina di dettaglio.
- Trova la scheda Licenza di test sviluppatore e fai clic su Genera.
- 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,::1e i nomi che terminano con.test,.localo.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?