Aller au contenu

Jetons API et licence sandbox

84 vues · Mis à jour Nov 22, 2026

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

  1. Rendez-vous sur /author/api-tokens en étant connecté à votre compte auteur.
  2. Sous Créer un nouveau jeton, saisissez un Nom du jeton qui indique où il sera utilisé, par exemple « Serveur de build ».
  3. Cliquez sur Créer un jeton.
  4. 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.
Page Jetons API avec un champ Nom du jeton et un bouton Créer un jeton, une section Vos jetons indiquant Aucun jeton API créé pour le moment, et un encadré Utilisation de l'API présentant un exemple de requête de vérification et ses en-têtes
La page Jetons API dans le panneau auteur.

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.

  1. Ouvrez /author/sandbox-license. Si vous n'avez encore aucun produit, votre tableau de bord auteur affiche aussi un bouton Obtenir une licence sandbox.
  2. 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.
  3. 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.
  4. Configurez votre installeur avec le slug de la sandbox et déroulez vos scénarios de vérification.
Page Licence SDK Sandbox avec une carte Votre licence dev sandbox listant les domaines locaux autorisés et un bouton Générer, suivie d'un avis jaune Lorsque vous publiez votre propre produit et d'un lien de retour vers le Guide d'intégration de licence
Générez une clé sandbox depuis la page Licence SDK Sandbox.

Licences développeur pour vos propres produits

Une fois que vous avez un produit, testez directement avec celui-ci :

  1. Ouvrez Mes produits et cliquez sur le produit pour afficher sa page de détail.
  2. Repérez la carte Licence de test développeur et cliquez sur Générer.
  3. 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, ::1 et les noms se terminant par .test, .local ou .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 ?