ArgorantDocs

Authentification

Les clés API, l'URL de base, ce que permet chaque scope de clé et comment les agents IA se connectent sans clé.

URL de base

Text
https://app.argorant.com/api/v1

Clés API

Connectez-vous sur app.argorant.com/profile et créez une clé dans Clés API. Les clés commencent par ag_live_ et ne s'affichent qu'une fois. Donnez à chaque clé le nom de ce qui l'utilise, comme zapier, ci ou laptop, pour pouvoir en révoquer une sans casser les autres.

Envoyez la clé à chaque appel :

Shell
curl "https://app.argorant.com/api/v1/account" \
  -H "Authorization: Bearer $ARGORANT_API_KEY"

La réponse vous indique pour qui agit la clé, votre forfait, vos crédits, combien de requêtes par minute la clé peut envoyer et ce qu'il reste des limites du jour. Appelez-la avant une grosse tâche.

Les clés API fonctionnent pendant l'essai de 7 jours et sur tous les forfaits. L'outil en ligne de commande lit la même clé via npx argorant login ou depuis la variable ARGORANT_API_KEY.

Scopes

Une clé créée dans l'app dispose de tous les scopes ci-dessous. Une clé plus restreinte reçoit 403 avec le code scope_missing lorsqu'elle appelle quelque chose en dehors de ses scopes.

ScopePermetPeut coûter
argorant:read_countsComptages, listes de mots, compte, lecture des campagnes, boîte de réception, boîtes mail et webhooksRien
argorant:search_segmentsAperçus masqués de personnes et d'entreprisesRien
argorant:manage_listsListes, campagnes, lancement, réponses aux réponses, statuts, boîtes mail, liste d'exclusion, webhooks, commandes de boîtes mailLes commandes de boîtes mail coûtent de l'argent, après un oui
argorant:unlock_contactsDéblocages, numéros de téléphone, enrichissement de personnes, recherche d'e-mailCrédits
argorant:create_exportsExports et exports de listesCrédits
argorant:verify_emailsVérification de vos propres listesCrédits, un demi-crédit par nouvelle vérification

Les agents IA se connectent, ils ne voient jamais la clé

Les clients MCP comme Claude et ChatGPT se connectent à https://mcp.argorant.com/mcp et s'authentifient avec OAuth 2.1 (code d'autorisation avec PKCE). Ils agissent pour votre compte avec les scopes que vous approuvez, et votre clé API n'apparaît jamais dans une conversation. Voir Connecter un client.

Autorisations au sein d'un espace de travail

Une clé agit au nom de la personne qui l'a créée. Les propriétaires et les membres ne voient que leur propre espace de travail. Certaines actions, comme commander des boîtes mail, sont réservées au propriétaire de l'espace de travail ; un membre reçoit 403 avec un message clair qui le dit. Les éléments d'autres espaces de travail répondent toujours 404 not_found, comme les éléments qui n'existent pas.

Sur cette page