Documentation

Clés API

Générez et gérez des clés API pour un accès programmatique.

Les clés API permettent un accès programmatique à vos agents. Utilisez-les pour intégrer Agentkit dans vos applications ou pour connecter des services tiers.

Remarque : les clés API nécessitent un forfait Hobby ou supérieur avec facturation active. Les espaces de travail Free, en retard de paiement ou impayés n’ont pas accès à l’API. Passez à un forfait supérieur →

Créer une clé API

  1. Accédez à votre espace de travail
  2. Cliquez sur Clés API dans la barre latérale
  3. Cliquez sur Créer une clé API
  4. Confirmez dans la boîte de dialogue

La nouvelle clé apparaît dans la liste et peut être révélée ou copiée à tout moment.

Afficher et copier des clés

Chaque clé de la liste est masquée par défaut. Utilisez l’icône en forme d’œil pour révéler une clé et l’icône de copie pour la copier dans votre presse-papiers.

Utiliser des clés API

Incluez la clé dans vos requêtes API :

curl -X POST 'https://your-domain.com/api/v1/chat' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"chatbotId": "uuid", "messages": [{"role": "user", "content": "Hello"}]}'

Documentation complète de l’API →

Gérer les clés

Afficher toutes les clés

Toutes les clés de l’espace de travail sont répertoriées sur la page Clés API.

Supprimer une clé

  1. Trouvez la clé dans la liste
  2. Cliquez sur l’icône de la corbeille
  3. Confirmez la suppression

Les clés supprimées cessent de fonctionner immédiatement.

Bonnes pratiques de sécurité

Ne jamais exposer vos clés

  • Ne validez pas de clés dans un dépôt git
  • N’incluez pas de clés dans du code côté client
  • Utilisez des variables d’environnement

Faire tourner vos clés régulièrement

  • Créez de nouvelles clés régulièrement
  • Mettez à jour vos applications
  • Supprimez les anciennes clés

Utiliser des clés distinctes

Créez des clés différentes pour :

  • La production et le développement
  • Différentes applications
  • Différents membres de l’équipe ou services

Portée des clés

Les clés API sont limitées à l’espace de travail dans lequel elles sont créées et ont accès à :

  • Tous les agents de l’espace de travail
  • Les points de terminaison de l’API de chat
  • La gestion des webhooks

Les clés ne peuvent pas :

  • Gérer les membres de l’équipe
  • Accéder à la facturation
  • Créer d’autres clés API

Connexion à Zapier

Pour vous connecter à Zapier :

  1. Créez une clé API dédiée à Zapier
  2. Utilisez cette clé dans la connexion Zapier
  3. Gardez cette clé distincte de vos autres usages

Configurer Zapier →

Dépannage

Erreur « Invalid API key »

  • Vérifiez que la clé a été copiée correctement
  • Recherchez d’éventuels espaces en début ou fin de clé
  • Confirmez que la clé n’a pas été supprimée

Erreur « Key not authorized »

  • Assurez-vous que l’agent appartient à votre espace de travail
  • Vérifiez que l’espace de travail de la clé correspond
  • Confirmez que votre espace de travail est sur Hobby ou supérieur, avec facturation active

La clé ne fonctionne pas après sa création

  • Essayez d’actualiser la page
  • Patientez 30 secondes le temps de la propagation
  • Créez une nouvelle clé si le problème persiste

Étapes suivantes