Développeurs

Clés API

Créez une clé pour votre propre logiciel et envoyez-la avec chaque requête à l'API HANC.

Une clé API permet à votre propre logiciel d'utiliser l'API HANC : lister les appels, créer des agents, acheter des numéros, lire votre CRM. Une clé agit avec vos droits d'accès — ce que vous pouvez faire dans le tableau de bord, elle peut le faire via l'API.

Créer une clé

1. Ouvrir les clés

   Intégrations → l'onglet Développeurs → Clés API de l’espace.

2. En créer une

   Cliquez sur Créer un jeton API. La clé apparaît dans la liste ; le bouton d'affichage la révèle, copiez-la depuis là.

• Jusqu'à 3 clés par espace de travail.
• Les clés n'ont ni nom ni droits propres : une clé dispose de votre accès dans chaque espace de travail dont vous êtes membre.
• Une clé peut être réaffichée depuis la liste — considérez la liste comme sensible.

L'utiliser

Envoyez la clé dans l'en-tête x-api-key, sans préfixe Bearer :

curl "https://api.hanc.ai/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

Chaque endpoint est décrit dans la Référence API.

La protéger

• Gardez les clés sur votre serveur — jamais dans un navigateur, une application mobile ou tout ce qu'un utilisateur peut ouvrir.
• Ne les ajoutez jamais à un système de gestion de versions.
• Renouvelez-les de temps en temps ; supprimez une clé immédiatement quand quelqu'un part ou si elle a pu fuiter.

Voir aussi

• Référence API
• Webhooks et livraison — les données d'appel envoyées à votre système après chaque appel