Jetons API et licence sandbox
Les auteurs disposent de deux outils pour intégrer des vérifications de licence dans un produit : les jetons API, qui authentifient les requêtes envoyées à l'API AppTrovo au nom de votre compte, et les licences de test développeur gratuites, qui vous permettent d'exécuter tout le processus de vérification de licence sur votre propre machine avant qu'un acheteur ne possède une clé.
Jetons API
Quand avez-vous besoin d'un jeton ?
Le point de terminaison de vérification des licences (/api/v1/licenses/verify) est public. Votre produit n'a pas besoin de jeton pour vérifier la clé d'un acheteur. Les jetons servent aux parties authentifiées de l'API, comme la liste des licences détenues par votre compte (/api/v1/licenses) ou la lecture de vos propres données d'auteur sous /api/v2/author/.
Un jeton agit au nom de votre compte. Ne placez jamais un jeton dans un produit que vous vendez, dans un dépôt public ou dans du code côté client. Quiconque le possède peut effectuer des appels API à votre place.
Créer un jeton
- Rendez-vous sur /author/api-tokens en étant connecté à votre compte auteur.
- Sous Créer un nouveau jeton, saisissez un Nom du jeton qui indique où il sera utilisé, par exemple « Serveur de build ».
- Cliquez sur Créer un jeton.
- Copiez immédiatement le jeton affiché dans l'encadré vert. Il ne sera plus jamais affiché. Cliquez sur Ignorer une fois que vous l'avez conservé en lieu sûr.

Envoyez le jeton dans l'en-tête Authorization: Bearer , accompagné de Accept: application/json.
Gérer et révoquer des jetons
Vos jetons liste chaque jeton avec son nom, sa date de création et sa dernière utilisation, ou « Jamais utilisé ». Vous pouvez avoir jusqu'à 10 jetons à la fois. Les jetons n'expirent pas d'eux-mêmes : révoquez donc ceux dont vous n'avez plus besoin en cliquant sur Révoquer puis en confirmant. Un jeton révoqué cesse immédiatement de fonctionner. Si un jeton a pu fuiter, révoquez-le et créez-en un nouveau.
La licence sandbox du SDK
La sandbox vous permet de tester la vérification de licence avant même d'avoir créé un produit. Elle vous fournit une clé développeur pour un produit sandbox partagé dont le slug est apptrovo-sdk-sandbox.
- Ouvrez /author/sandbox-license. Si vous n'avez encore aucun produit, votre tableau de bord auteur affiche aussi un bouton Obtenir une licence sandbox.
- Cliquez sur Générer. Votre clé apparaît avec un bouton de copie, sa date d'expiration, les emplacements de domaine utilisés et le slug du produit.
- Copiez les commandes Test rapide affichées sous la clé. La première, qui utilise
domain=localhost, doit renvoyer"valid": true. La seconde, qui utilise un domaine public, doit être rejetée. - Configurez votre installeur avec le slug de la sandbox et déroulez vos scénarios de vérification.

Licences développeur pour vos propres produits
Une fois que vous avez un produit, testez directement avec celui-ci :
- Ouvrez Mes produits et cliquez sur le produit pour afficher sa page de détail.
- Repérez la carte Licence de test développeur et cliquez sur Générer.
- Copiez la clé et le slug du produit depuis la carte, puis utilisez la commande Test rapide pour vérifier qu'elle fonctionne.
Au moment de la publication, remplacez le slug de la sandbox dans la configuration de votre installeur par le slug réel de votre produit. Le reste de votre intégration ne change pas.
Règles des licences développeur
Les licences sandbox et les licences développeur par produit fonctionnent de la même façon :
- Elles ne sont validées que sur des noms d'hôte locaux :
localhost,127.0.0.1,::1et les noms se terminant par.test,.localou.localhost. Un vrai domaine est rejeté, la clé ne peut donc pas servir en production. - Chaque vérification doit inclure le paramètre
domain. - Chaque clé dispose de 5 emplacements de domaine et reste valide 30 jours. Cliquez sur Prolonger de 30 jours sur la même carte pour repousser l'expiration. La clé reste identique.
- Vous avez droit à une licence développeur par produit. Générer à nouveau prolonge la clé existante au lieu d'en créer une nouvelle.
- La réponse de vérification indique
"license_type": "developer"et"is_dev": true, ce qui permet à votre code de distinguer les clés de test.
Questions fréquentes
Pourquoi Jetons API n'apparaît-il pas dans la barre latérale ?
La page n'a actuellement aucune entrée de menu. Ajoutez /author/api-tokens à vos favoris.
Ma clé développeur indique « License has expired »
Ouvrez la carte depuis laquelle vous l'avez créée et cliquez sur Prolonger de 30 jours. La même clé fonctionne de nouveau.
Articles associés
Cet article vous a-t-il été utile ?