Clés API

Votre clé API est le secret qui authentifie chaque appel que vous adressez à TrustyData. Sans elle, l'API renvoie une erreur 401 Unauthorized. Elle doit être transmise dans l'en-tête HTTP Authorization: Bearer <votre-clé> à chaque requête.

Créer une clé

Depuis la page Clés API de l'espace client, cliquez sur le bouton + Créer ma clé situé en haut à droite de l'écran pour ouvrir la modale de création.

1. Créer ma clé — ouvre la modale de création d'une nouvelle clé API.

La modale vous demande de choisir l'environnement de la clé :

• Live — clé de production. Le préfixe commence par td_live_.
• Staging — clé pour vos environnements de test. Le préfixe commence par td_staging_.

Après confirmation, le secret complet est affiché une seule fois dans un encart dédié, avec un bouton Copier. Copiez-le immédiatement et stockez-le dans votre gestionnaire de secrets ou dans les variables d'environnement de votre application. Une fois la modale fermée, seul le préfixe (par exemple td_live_0viQ…) reste visible dans le tableau — le secret complet ne peut plus être récupéré.

Régénérer / révoquer

Chaque ligne du tableau de clés dispose d'un menu d'actions (icône à trois points en bout de ligne). Ce menu propose deux actions :

• Régénérer — génère un nouveau secret pour la même clé. L'ancien secret cesse immédiatement de fonctionner. Utilisez cette action si vous soupçonnez une fuite ou une compromission.
• Révoquer — désactive définitivement la clé. Toute requête utilisant cette clé sera refusée avec une erreur 401.

Clés publiables

Sous votre clé secrète, la section Clés publiables gère un second type de clé, préfixé tdp_, destiné à être lu en clair dans le JavaScript d'une page publique : une carte des points de vente, un « trouver un magasin ». Elle n'ouvre qu'un seul endpoint, GET /locations/search, et ne fonctionne que depuis les domaines que vous y déclarez.

• Créer une clé publiable — vous saisissez les domaines autorisés, un par ligne, en https uniquement (dix au maximum). Un joker couvre les sous-domaines (https://*.exemple.fr) mais pas le domaine lui-même : qui veut les deux les déclare tous les deux.
• Modifier les domaines — ajoute ou retire un domaine sans changer la clé. C'est le bon geste pour ouvrir un nouveau site : votre page publique reste en ligne, vous n'avez rien à redéployer.
• Révoquer — la clé cesse de fonctionner en moins d'une minute, le temps du cache de validation. Pour remplacer une clé, émettez la nouvelle, déployez votre page, vérifiez, puis révoquez l'ancienne.

Contrairement à la clé secrète, une clé publiable est réaffichable à tout moment : elle vit déjà dans le code source de vos pages, la cacher ici ne protégerait rien. Le nombre de clés publiables actives est plafonné par votre plan, et le compteur au-dessus du tableau vous dit où vous en êtes ; ce plafond est indépendant de la règle « une clé secrète active » ci-dessus.