Créer une clé API serveur

Générez une clé secrète sk_live_ depuis le tableau de bord pour les appels de serveur à serveur vers l’API ThunderPhone, conservez-la en lieu sûr et effectuez une rotation ou révoquez-la si nécessaire.

Les clés API serveur (sk_live_...) authentifient les appels de serveur à serveur vers l’API ThunderPhone. Les clés se trouvent sous Organisation → Clés.

1. Ouvrir l’onglet Clés

   Accédez à Organisation → Clés et cliquez sur Créer une clé.

2. La nommer

   Choisissez un nom qui indique où la clé sera utilisée, par exemple « Backend de production ». Les noms servent uniquement d’étiquettes ; ils n’affectent pas les accès.

3. Créer la clé

   Cliquez sur Créer une clé dans la boîte de dialogue. Cela génère le secret.

4. La copier maintenant

   Le secret complet s’affiche une seule fois. Copiez-le dans votre gestionnaire de secrets — après votre départ, seul le préfixe reste visible.

L’utiliser#

La clé est associée à cette organisation ; les requêtes n’ont donc pas besoin d’identifiant d’organisation — uniquement de l’en-tête Bearer :

curl https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

À partir de là, le démarrage rapide de l’API vous mène à votre premier appel en trois requêtes supplémentaires.

Effectuer une rotation et révoquer#

Créez une nouvelle clé, migrez vos services, puis supprimez l’ancienne depuis le même onglet — la liste affiche le préfixe et le nom de chaque clé afin de les distinguer. Pour automatiser la rotation, appelez les endpoints des clés API développeur avec un jeton de session connecté. Une clé sk_live_ ne peut ni créer, ni lister, ni révoquer de clés ; une clé compromise ne peut donc pas générer son propre remplacement. Il en va de même pour les membres, les invitations, les paramètres de paiement et les autres contrôles du compte.

Étapes suivantes#