Clés API
Accès : Configuration → Clés API
Une clé API est le mot de passe qu'utilise un programme —votre ERP, un tableur connecté, votre propre tableau de bord— pour lire vos données Epinium sans se connecter à l'application. C'est sur cet écran qu'on les crée, qu'on modifie leurs autorisations et qu'on les annule.
Cette page explique l'écran. Pour savoir quelles informations vous pouvez consulter avec une clé et comment l'utiliser depuis un programme, consultez le guide de l'API.
Vous voulez seulement connecter un assistant IA ?
Vous n'avez besoin d'aucune clé. Allez dans Configuration → MCP et autorisez l'assistant depuis le navigateur.
Les requêtes consomment des crédits
Chaque appel à l'API dépense des crédits de votre compte, les mêmes que ceux utilisés par les fonctions d'IA. Les prix par ressource se trouvent dans Configuration → Crédits, à la rubrique API publique et connecteur MCP.
Deux choses qui évitent les mauvaises surprises : vous n'êtes facturé que pour ce qui est livré, donc un appel qui échoue ne dépense rien ; et dans les requêtes de métriques, ce qui coûte est la plage de dates, pas le nombre de lignes. Si vous n'avez plus de crédits, l'appel est rejeté avant son exécution et la réponse indique ce qu'il faut raccourcir.
Le détail des en-têtes de coût et de cette erreur se trouve dans le guide de l'API.
Créer une clé
- Cliquez sur Créer une clé API
- Donnez-lui un nom qui vous rappelle à quoi elle sert (par exemple, intégration ERP) : c'est la seule chose que vous verrez ensuite pour les distinguer
- Réglez le niveau d'accès de chaque section : la clé arrive en lecture seule, ce dont presque toute intégration a besoin. Si la vôtre doit modifier quelque chose, montez cette section sur Modifier
- Enregistrez et copiez le secret qui s'affiche
- Collez-le dans l'outil qui va l'utiliser
Le secret ne s'affiche qu'une seule fois
À la création de la clé, sa valeur complète apparaît une seule fois. Dès que vous fermez la fenêtre, elle ne peut plus être récupérée, ni depuis Epinium ni par le support.
Les autorisations
Chaque clé n'atteint que les sections que vous lui ouvrez, au niveau que vous leur donnez. Donnez-lui le minimum dont l'intégration a besoin : s'il lui en faut davantage demain, vous le montez sans changer la clé.
| Section | Ce qu'elle ouvre |
|---|---|
| Catalogue | Vos produits, marques, pays et regroupements de mots-clés, avec leurs métriques. En Modifier, créer des regroupements de mots-clés, changer leurs mots-clés et leurs produits, et les supprimer |
| Campagnes | Campagnes, portefeuilles, groupes d'annonces, ciblages, annonces produit et termes de recherche, avec leurs métriques. En Modifier, créer des campagnes et des portefeuilles et changer enchères, budgets et état sur Amazon |
| Connexions | Les comptes Amazon et les boutiques Shopify et WooCommerce connectés à Epinium : ce que vous avez connecté, pas ce qu'il contient |
| Données de vos boutiques et plateformes connectées | Ce que contiennent vos boutiques Shopify et WooCommerce : produits, stock, prix et le reste de ce qu'elles exposent, et le registre des modifications qui y sont faites. C'est ce qu'utilise un assistant IA pour interroger la boutique. En Modifier, créer, modifier et supprimer des produits et du contenu directement dans la boutique, sans validation préalable |
| Tâches | Les tâches Epinium et leurs suggestions. En Modifier, créer des tâches, approuver ou rejeter leurs suggestions et appliquer ce qui a été approuvé |
| CMO Brain | Le catalogue de playbooks marketing d'Epinium |
| Flux de travail | Vos automatisations, leur configuration et les performances des campagnes qu'elles optimisent |
Chaque section se règle sur l'un des trois niveaux : Aucun accès, Voir ou Modifier. Aujourd'hui, le Catalogue, les Campagnes, les Données de vos boutiques et plateformes connectées, les Tâches et les Flux de travail acceptent Modifier, et Modifier inclut Voir : une intégration qui écrit lit aussi.
Modifier est réservé aux plans Business et Master. En Free et Guru, les clés lisent et le niveau Modifier apparaît verrouillé. Si vous passez à l'un de ces plans, une clé qui avait déjà Modifier continue de servir pour lire, mais ses écritures sont refusées.
Au-dessus, deux modèles déplacent toutes les sections d'un coup : Accès complet et Lecture seule. Une clé a besoin d'au moins une autorisation : sans aucune, elle échouerait à chacun de ses appels et ne peut donc pas être enregistrée ainsi.
Ce que vous voyez dans le tableau
| Colonne | Ce qu'elle vous indique |
|---|---|
| Nom | Celui que vous lui avez donné à la création, avec le préfixe en dessous : les premiers caractères du secret, pour la reconnaître sans révéler le reste |
| Accès | Un résumé en une étiquette : Accès complet, Lecture seule, Personnalisé (une combinaison sur mesure) ou Aucun accès en rouge, qui signifie que cette clé ne fonctionne pas |
| Dernière utilisation | Quand elle a servi pour la dernière fois. Si la mention Jamais utilisée apparaît, personne n'a réussi à la connecter |
| Créée | La date d'émission |
La colonne Dernière utilisation est le moyen rapide de repérer les clés oubliées : une clé inutilisée depuis des mois est presque toujours superflue, et chaque clé active est une porte ouverte de plus.
Modifier les autorisations d'une clé
Vous pouvez modifier une clé existante et monter ou descendre le niveau de chaque section. Le changement s'applique immédiatement et la clé reste la même : rien à modifier là où vous l'avez configurée.
C'est la meilleure façon d'élargir ou de restreindre la portée d'une intégration, car cela évite de générer un nouveau secret et de le redistribuer.
Révoquer une clé
Révoquer annule la clé définitivement. Toute intégration qui l'utilise cesse de fonctionner immédiatement, mieux vaut donc savoir au préalable qui s'en sert : la colonne Dernière utilisation et le nom que vous lui avez donné sont l'indice.
Une clé révoquée ne peut pas être réactivée. Si l'intégration doit refonctionner, créez-en une nouvelle et remplacez le secret là où il était renseigné.
Si vous perdez le secret
Il est irrécupérable. La seule issue est de révoquer la clé et d'en créer une autre, puis de changer le secret dans l'outil qui l'utilisait.
C'est pourquoi il vaut mieux l'enregistrer dès sa création dans le gestionnaire de mots de passe de l'équipe, plutôt que dans un e-mail ou une conversation.
Si vous êtes une agence
Cette section apparaît aussi dans votre propre compte d'agence, comme MCP et contrairement aux Connexions. Et l'endroit où vous créez la clé change sa portée :
- Créée dans votre compte d'agence, la clé est la vôtre et atteint les comptes que vos clients vous ont partagés. Chaque requête doit préciser sur lequel elle opère.
- Créée dans le compte d'un client, la clé appartient à ce client et n'atteint que ses connexions.
Si votre but est de connecter un assistant IA, aucune clé n'est nécessaire : voyez Configuration → MCP.