Open in
Создайте серверный API-ключ
Создайте секретный ключ sk_live_ в панели управления для межсерверных вызовов API ThunderPhone, храните его в безопасности и при необходимости меняйте или отзывайте.
Серверные ключи API (sk_live_...) аутентифицируют межсерверные вызовы
API ThunderPhone. Ключи находятся в разделе Организация → Ключи.
- Откройте вкладку «Ключи»
Перейдите в раздел Организация → Ключи и нажмите Создать ключ.
- Задайте имя
Выберите имя, указывающее, где будет использоваться ключ, например «Бэкенд продакшена». Имена служат только метками и не влияют на доступ.
- Создайте ключ
Нажмите Создать ключ в диалоговом окне. Будет создан секрет.
- Скопируйте его сейчас
Полный секрет отображается ровно один раз. Скопируйте его в менеджер секретов — после выхода будет виден только префикс.
Использование
Ключ привязан к этой организации, поэтому запросам не нужен идентификатор организации — достаточно заголовка Bearer:
curl https://api.thunderphone.com/v1/agents \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"Далее быстрый старт API поможет выполнить первый звонок ещё за три запроса.
Ротация и отзыв
Создайте новый ключ, перенесите на него свои сервисы, затем удалите старый
на той же вкладке — в списке указаны префикс и имя каждого ключа, чтобы
их можно было различать. Чтобы автоматизировать ротацию, вызовите
эндпоинты ключей API разработчика с токеном
выполненного входа в сеанс. Ключ sk_live_ не может создавать, перечислять или отзывать
ключи, поэтому скомпрометированный ключ не может выпустить себе замену. То же относится к
участникам, приглашениям, настройкам оплаты и другим
элементам управления аккаунтом.