Een server-API-sleutel maken

Maak vanuit het dashboard een geheime sk_live_-sleutel voor server-naar-serveraanroepen naar de ThunderPhone API, bewaar deze veilig en roteer of trek deze indien nodig in.

Server-API-sleutels (sk_live_...) verifiëren server-naar-serveraanroepen naar de ThunderPhone API. Sleutels staan onder Organisatie → Sleutels.

1. Open het tabblad Sleutels

   Ga naar Organisatie → Sleutels en klik op Sleutel maken.

2. Geef de sleutel een naam

   Kies een naam die aangeeft waar de sleutel wordt gebruikt, zoals "Productie-backend". Namen zijn alleen labels; ze hebben geen invloed op toegang.

3. Maak de sleutel

   Klik in het dialoogvenster op Sleutel maken. Hiermee wordt het geheim gegenereerd.

4. Kopieer deze nu

   Het volledige geheim wordt precies één keer weergegeven. Kopieer het naar je geheimenbeheer — nadat je weggaat, blijft alleen het voorvoegsel zichtbaar.

Gebruik de sleutel#

De sleutel is gekoppeld aan deze organisatie, dus aanvragen hebben geen organisatie-ID nodig — alleen de Bearer-header:

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

Vanaf hier brengt de API-snelstart je met nog drie aanvragen naar je eerste oproep.

Roteer en trek in#

Maak een nieuwe sleutel, migreer je services en verwijder vervolgens de oude op hetzelfde tabblad — de lijst toont de prefix en naam van elke sleutel, zodat je ze van elkaar kunt onderscheiden. Om rotatie te automatiseren, roep je de eindpunten voor API-sleutels voor ontwikkelaars aan met een sessietoken van een ingelogde gebruiker. Een sk_live_-sleutel kan geen sleutels maken, weergeven of intrekken, dus een gelekte sleutel kan geen eigen vervanging aanmaken. Hetzelfde geldt voor leden, uitnodigingen, betaalinstellingen en andere accountbeheerfuncties.

Volgende stappen#