Une clé API permet à un programme d'agir pour votre compte. L'outil en ligne de commande, l'API REST, une étape Zapier ou votre propre script en utilisent une. Les apps d'IA qui gèrent la connexion par identifiant, comme Claude et ChatGPT, n'ont besoin d'aucune clé.
Créer une clé
Ouvrez Paramètres et choisissez Clés API.
- Saisissez un nom dans le champ à côté de Nouvelle clé. Nommez-la d'après l'endroit où elle sera utilisée, par exemple « cli sur mon portable » ou « zapier ».
- Cliquez sur Créer une clé.
- Copiez la clé immédiatement. Elle commence par
ag_live_et n'est affichée en entier qu'une seule fois. Ensuite, la liste affiche ses premiers caractères, sa date de création et sa dernière utilisation.
Stockez la clé dans un gestionnaire de mots de passe ou dans les réglages secrets de votre outil. Ne la mettez jamais dans un document partagé, une capture d'écran ou un chat.
Utiliser la clé
L'outil en ligne de commande demande la clé une seule fois quand vous lancez npx argorant login et la conserve sur votre ordinateur. Pour l'API REST, vous l'envoyez dans un en-tête à chaque requête.
curl https://app.argorant.com/api/mcp/account \
-H "Authorization: Bearer ag_live_..."Ce premier appel affiche votre forfait et votre solde, ce qui permet de vérifier que la clé fonctionne. Les clés API et l'API REST liste les principaux endpoints, et la CLI Argorant couvre l'outil en ligne de commande.
Une clé par outil
Donnez à chaque outil et à chaque personne sa propre clé. Vous voyez alors quelle clé a été utilisée et quand, et vous pouvez en désactiver une sans tout casser. Les clés partagent les crédits de votre compte : une clé n'a pas son propre solde. Chaque clé a sa propre limite de débit, et les recherches ont des limites quotidiennes pendant l'essai. Limites de débit et quotas quotidiens donne les chiffres de chaque forfait.
Renouveler et révoquer
Pour remplacer une clé, créez d'abord la nouvelle, mettez-la dans l'outil, vérifiez qu'elle fonctionne, puis cliquez sur Révoquer à côté de l'ancienne. La révocation est immédiate. La requête suivante avec l'ancienne clé est refusée.
Si une clé se retrouve là où elle ne devrait pas être, comme un dépôt de code public ou un écran partagé, révoquez-la immédiatement et créez-en une nouvelle. Examinez ensuite vos exports récents pour voir si quelque chose a été lancé sans vous. Que faire en cas de fuite d'une clé API donne la check-list complète.
Webhooks
Sous les clés, vous pouvez ajouter un webhook. Argorant appelle alors votre adresse quand quelque chose se produit, par exemple quand un export est prêt, qu'une liste a fini de se remplir, qu'une réponse est arrivée ou qu'une campagne a été mise en pause. Collez l'adresse sous Nouveau webhook, choisissez les événements et cliquez sur Ajouter un webhook. Chaque appel est signé, pour que votre serveur puisse vérifier qu'il vient de nous. Webhooks montre le contenu de chaque événement.
