---
title: "Создайте серверный API-ключ"
description: "Создайте секретный ключ sk_live_ в панели управления для межсерверных вызовов API ThunderPhone, храните его в безопасности и при необходимости меняйте или отзывайте."
---

Серверные ключи API (`sk_live_...`) аутентифицируют межсерверные вызовы
API ThunderPhone. Ключи находятся в разделе **Организация → Ключи**.

<Warning>
  Серверные ключи — это секреты. Никогда не включайте их в клиентский код —
  для браузеров используйте ограниченные доменом
  [публикуемые ключи](/api-reference/publishable-keys) (`pk_live_...`).
</Warning>

<Steps>
  <Step title="Откройте вкладку «Ключи»">
    Перейдите в раздел **Организация → Ключи** и нажмите **Создать ключ**.
  </Step>
  <Step title="Задайте имя">
    Выберите имя, указывающее, где будет использоваться ключ, например «Бэкенд продакшена». Имена служат только метками и не влияют на доступ.
  </Step>
  <Step title="Создайте ключ">
    Нажмите **Создать ключ** в диалоговом окне. Будет создан секрет.
  </Step>
  <Step title="Скопируйте его сейчас">
    Полный секрет отображается **ровно один раз**. Скопируйте его в
    менеджер секретов — после выхода будет виден только префикс.
  </Step>
</Steps>

## Использование

Ключ привязан к этой организации, поэтому запросам не нужен идентификатор организации —
достаточно заголовка Bearer:

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

Далее [быстрый старт API](/ru/quickstart) поможет выполнить первый
звонок ещё за три запроса.

## Ротация и отзыв

Создайте новый ключ, перенесите на него свои сервисы, затем удалите старый
на той же вкладке — в списке указаны префикс и имя каждого ключа, чтобы
их можно было различать. Чтобы автоматизировать ротацию, вызовите
[эндпоинты ключей API разработчика](/api-reference/developer-api-keys) с токеном
выполненного входа в сеанс. Ключ `sk_live_` не может создавать, перечислять или отзывать
ключи, поэтому скомпрометированный ключ не может выпустить себе замену. То же относится к
участникам, приглашениям, настройкам оплаты и другим
[элементам управления аккаунтом](/api-reference/introduction#what-api-keys-cant-do).

<Note>
  Серверные ключи API — это машинные учетные данные, на которые не
  распространяется политика организации [**Требовать ключи доступа**](/ru/guides/sso)
  — этот параметр проверяет входы пользователей, а не ключи `sk_live_...`.
  Поэтому своевременная ротация и отзыв ключей здесь — основной способ
  контролировать постоянный доступ к API; если ключи доступа обязательны,
  панель политики безопасности показывает, сколько активных ключей сейчас
  освобождены от этого требования.
</Note>

<Tip>
  Попросите встроенного копилота «создать ключ API», и он проведёт вас
  через этот процесс, в реальном времени выделяя каждый элемент управления.
</Tip>

---

## Следующие шаги

<CardGroup cols={2}>
  <Card title="Быстрый старт API" icon="terminal" href="/ru/quickstart">
    Агент, номер, вебхук, первый звонок — четыре REST-запроса.
  </Card>
  <Card title="Справочник по аутентификации" icon="lock" href="/api-reference/introduction">
    Как работают аутентификация Bearer и привязка к организации.
  </Card>
</CardGroup>