---
title: "Luo palvelimen API-avain"
description: "Luo hallintapaneelissa sk_live_-salainen avain palvelimelta palvelimelle tehtäviä ThunderPhone API -kutsuja varten, säilytä se turvallisesti ja kierrätä tai peruuta se tarvittaessa."
---

Palvelin-API-avaimet (`sk_live_...`) todentavat palvelinten väliset kutsut
ThunderPhone APIin. Avaimet löytyvät kohdasta **Organisaatio → Avaimet**.

<Warning>
  Palvelinavaimet ovat salaisuuksia. Älä koskaan sisällytä sellaista asiakaspuolen koodiin — käytä
  selaimissa sen sijaan verkkotunnukseen rajoitettuja
  [julkaistavia avaimia](/api-reference/publishable-keys) (`pk_live_...`).
</Warning>

<Steps>
  <Step title="Avaa Avaimet-välilehti">
    Siirry kohtaan **Organisaatio → Avaimet** ja napsauta **Luo avain**.
  </Step>
  <Step title="Nimeä avain">
    Valitse nimi, joka kertoo, missä avain sijaitsee — esimerkiksi "Tuotannon
    taustajärjestelmä". Nimet ovat vain tunnisteita, eivätkä ne vaikuta käyttöoikeuksiin.
  </Step>
  <Step title="Luo avain">
    Napsauta valintaikkunassa **Luo avain**. Tämä luo salaisuuden.
  </Step>
  <Step title="Kopioi se nyt">
    Koko salaisuus näytetään **vain kerran**. Kopioi se
    salaisuuksien hallintaan — poistuttuasi näkyvissä on vain etuliite.
  </Step>
</Steps>

## Käytä avainta

Avain on sidottu tähän organisaatioon, joten pyynnöt eivät tarvitse organisaatiotunnusta —
vain Bearer-otsakkeen:

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

Tästä eteenpäin [API-pikaopas](/fi/quickstart) vie sinut ensimmäiseen
puheluusi kolmella lisäpyynnöllä.

## Kierrätä ja peruuta

Luo uusi avain, siirrä palvelusi siihen ja poista sitten vanha avain
samalta välilehdeltä — luettelossa näkyvät kunkin avaimen etuliite ja nimi,
jotta voit erottaa ne toisistaan. Automatisoi kierto kutsumalla
[kehittäjän API-avainten päätepisteitä](/api-reference/developer-api-keys)
sisäänkirjautuneen istunnon tunnuksella. `sk_live_`-avain ei voi luoda, luetteloida eikä peruuttaa
avaimia, joten vuotanut avain ei voi luoda omaa korvaajaansa. Sama koskee
jäseniä, kutsuja, maksuasetuksia ja muita
[tilin hallintatoimintoja](/api-reference/introduction#what-api-keys-cant-do).

<Note>
  Palvelin-API-avaimet ovat koneen tunnistetietoja, eikä niihin sovelleta organisaatiosi
  [**Vaadi pääsyavaimet**](/fi/guides/sso)
  -käytäntöä — tämä asetus tarkistaa ihmisten kirjautumiset, ei `sk_live_...`-avaimia.
  Siksi avainten nopea kierrätys ja peruutus täällä on tärkein hallintakeinosi
  jatkuvaan API-käyttöoikeuteen. Jos pääsyavaimia vaaditaan,
  tietoturvakäytäntöpaneeli näyttää, kuinka monta aktiivista avainta on tällä hetkellä
  vapautettu vaatimuksesta.
</Note>

<Tip>
  Pyydä sovelluksen sisäistä apukopilottia "luomaan API-avain", niin se opastaa sinut
  tämän työnkulun läpi ja korostaa jokaisen hallintatoiminnon reaaliajassa.
</Tip>

---

## Seuraavat vaiheet

<CardGroup cols={2}>
  <Card title="API-pikaopas" icon="terminal" href="/fi/quickstart">
    Agentti, numero, webhook, ensimmäinen puhelu — neljä REST-kutsua.
  </Card>
  <Card title="Todennuksen ohje" icon="lock" href="/api-reference/introduction">
    Näin Bearer-todennus ja organisaatiosidonta toimivat.
  </Card>
</CardGroup>