Server-API-Schlüssel erstellen

Erstellen Sie im Dashboard einen geheimen sk_live_-Schlüssel für Server-zu-Server-Aufrufe der ThunderPhone API, bewahren Sie ihn sicher auf und rotieren oder widerrufen Sie ihn bei Bedarf.

Server-API-Schlüssel (sk_live_...) authentifizieren Server-zu-Server-Aufrufe an die ThunderPhone API. Schlüssel finden Sie unter Organisation → Schlüssel.

1. Registerkarte „Schlüssel“ öffnen

   Gehen Sie zu Organisation → Schlüssel und klicken Sie auf Schlüssel erstellen.

2. Benennen

   Wählen Sie einen Namen, der angibt, wo der Schlüssel verwendet wird — etwa „Produktions- Backend“. Namen dienen nur als Bezeichnungen und beeinflussen den Zugriff nicht.

3. Schlüssel erstellen

   Klicken Sie im Dialog auf Schlüssel erstellen. Dadurch wird das Geheimnis generiert.

4. Jetzt kopieren

   Das vollständige Geheimnis wird genau einmal angezeigt. Kopieren Sie es in Ihren Secret Manager — nachdem Sie die Seite verlassen haben, bleibt nur das Präfix sichtbar.

Verwenden#

Der Schlüssel ist an diese Organisation gebunden, daher benötigen Anfragen keine Organisations-ID — nur den Bearer-Header:

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

Von hier aus führt Sie der API-Schnellstart mit drei weiteren Anfragen zu Ihrem ersten Anruf.

Rotieren und widerrufen#

Erstellen Sie einen neuen Schlüssel, stellen Sie Ihre Dienste darauf um und löschen Sie dann den alten über denselben Tab — die Liste zeigt Präfix und Namen jedes Schlüssels, damit Sie sie unterscheiden können. Um die Rotation zu automatisieren, rufen Sie die Endpunkte für Entwickler-API-Schlüssel mit einem Token einer angemeldeten Sitzung auf. Ein sk_live_-Schlüssel kann keine Schlüssel erstellen, auflisten oder widerrufen, sodass ein kompromittierter Schlüssel keinen eigenen Ersatz erstellen kann. Dasselbe gilt für Mitglieder, Einladungen, Zahlungseinstellungen und andere Kontosteuerungen.

Nächste Schritte#