Vytvoriť serverový kľúč API

Vytvorte tajný kľúč sk_live_ na ovládacom paneli pre volania rozhrania ThunderPhone API medzi servermi, uchovávajte ho v bezpečí a podľa potreby ho vymeňte alebo zrušte.

Serverové kľúče API (sk_live_...) overujú volania medzi servermi do rozhrania ThunderPhone API. Kľúče nájdete v časti Organizácia → Kľúče.

1. Otvorte kartu Kľúče

   Prejdite do časti Organizácia → Kľúče a kliknite na Vytvoriť kľúč.

2. Pomenujte ho

   Zvoľte názov, ktorý označuje, kde bude kľúč používaný — napríklad „Produkčný backend“. Názvy slúžia iba ako označenia; nemajú vplyv na prístup.

3. Vytvorte kľúč

   V dialógovom okne kliknite na Vytvoriť kľúč. Tým sa vygeneruje tajný kľúč.

4. Skopírujte ho teraz

   Celý tajný kľúč sa zobrazí presne raz. Skopírujte ho do správcu tajomstiev — po odchode zostane viditeľná iba predpona.

Použitie#

Kľúč je viazaný na túto organizáciu, takže požiadavky nepotrebujú ID organizácie — stačí hlavička Bearer:

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

Odtiaľ vás rýchly štart API dovedie k prvému volaniu v troch ďalších požiadavkách.

Rotácia a zrušenie#

Vytvorte nový kľúč, presuňte naň svoje služby a potom odstráňte starý na tej istej karte — zoznam zobrazuje prefix a názov každého kľúča, aby ste ich mohli rozlíšiť. Ak chcete automatizovať rotáciu pomocou skriptu, zavolajte koncové body vývojárskych API kľúčov s tokenom relácie prihláseného používateľa. Kľúč sk_live_ nemôže vytvárať, vypisovať ani odvolávať kľúče, takže uniknutý kľúč nemôže vytvoriť vlastnú náhradu. To isté platí pre členov, pozvánky, nastavenia platieb a ďalšie ovládacie prvky účtu.

Ďalšie kroky#