Clés API

À quoi servent les clés API

Les clés API servent aux connexions de longue durée de tes propres agents et scripts quand la connexion OAuth dans un navigateur n'est pas pratique. Se connecter reste la méthode normale pour relier une app d'IA comme Claude ou ChatGPT. Consulte Configuration du MCP pour cette configuration.

Les clés utilisent le même compte et la même connexion Meta que l'app web et nécessitent l'accès au MCP, au CLI et à l'API sur ton compte. Elles fonctionnent depuis différents réseaux.

Créer une clé

Ouvre Account > MCP, CLI & API et choisis Create API Key dans API Keys.
Donne un nom à la clé pour reconnaître ce qui l'utilise.
Coche la case confirmant que la clé est réservée à une personne et ne doit pas être partagée, puis crée-la.
Copie le secret adk_ et conserve-le dans un endroit privé. Il n'est affiché qu'une seule fois.

Utiliser une clé avec le MCP

Envoie Authorization: Bearer adk_... à https://adsuploader.com/api/mcp. Pour un client MCP qui accepte les en-têtes personnalisés, la configuration peut ressembler à ceci :

{
  "mcpServers": {
    "ads-uploader": {
      "url": "https://adsuploader.com/api/mcp",
      "headers": { "Authorization": "Bearer adk_..." }
    }
  }
}

Remplace adk_... par ta clé et garde la configuration privée.

Utiliser une clé avec le CLI

Définis ADS_API_KEY dans les paramètres de secrets de ton serveur ou de ton système CI. Cette variable prend le pas sur les identifiants enregistrés dans ~/.config/adsuploader/credentials.json. Pour enregistrer une clé localement, lance plutôt :

ads login --api-key

Colle la clé dans l'invite de saisie masquée ou transmets-la via stdin. Le CLI la vérifie avant de l'enregistrer. Évite de mettre le secret dans la commande, où il peut apparaître dans l'historique du shell.

Lance ads whoami pour vérifier la méthode d'authentification. ads config l'affiche aussi ; seul le préfixe de la clé est visible.

Une clé par personne

Chaque compte peut avoir une clé active par défaut, pour une personne. Contacte le support si tu as besoin de plus de clés ; les administrateurs peuvent augmenter la limite jusqu'à 10. Ajoute une place d'équipe pour quelqu'un d'autre. Ne partage jamais une clé : Ads Uploader peut révoquer une clé utilisée par plusieurs personnes.

Les clés n'expirent pas

Les clés restent valides jusqu'à leur révocation. Les clés inutilisées sont révoquées après 90 jours et nous t'envoyons un email quand cela arrive. Le temps pendant lequel ton abonnement est en pause ne compte pas dans ces 90 jours.

Révoquer une clé

Ouvre Account > MCP, CLI & API, trouve la clé dans API Keys et choisis Revoke. Les requêtes qui utilisent cette clé ne fonctionneront plus.

ads logout retire seulement la clé enregistrée de cet ordinateur ; il ne la révoque pas. Il ne peut pas supprimer ADS_API_KEY, alors retire aussi cette variable de ton environnement ou de tes paramètres de secrets.

Les connexions par navigateur apparaissent séparément dans MCP and CLI-Connected AI Apps. Choisis Revoke à cet endroit pour révoquer une connexion CLI ou une connexion d'app d'IA.

Documentation