Создание ключа API
Создавайте ключи в консоли с лимитом расходов и сроком действия; полный ключ показывается только один раз.
API-ключ нужен до того, как вы начнёте вызывать API. Ключи создаются и управляются на странице «API-ключи» в консоли; одна учётная запись может содержать несколько ключей для разных целей.
Как создать ключ
- Войдите и откройте консоль, затем выберите API-ключи в левой навигации.
- Нажмите «Создать ключ» и заполните:
| Поле | Обязательно | Описание |
|---|---|---|
| Название | Да | Назовите ключ по его назначению, чтобы его было легко различать, например production, test. |
| Лимит расходов (USD) | Необязательно | Совокупный лимит расходов для этого ключа. Оставьте пустым, чтобы не ограничивать. |
| Срок действия | Необязательно | После этой даты ключ автоматически перестаёт работать. Оставьте пустым, если срок не нужен. |
- Отправьте форму для создания. В диалоге полный ключ показывается ровно один раз — скопируйте его и сразу сохраните в надёжном месте.
Как отображаются ключи
- Полный ключ показывается только один раз, в момент создания. После закрытия диалога его нельзя посмотреть снова.
- В списке ключей всегда отображается маскированная форма (префикс и последние 4 символа) для защиты от подглядывания.
- Потеряли ключ? Удалите его и создайте новый — новый ключ работает сразу.
Рекомендации по безопасности
- Никогда не помещайте ключ во фронтенд-код, публичный репозиторий или сообщение в чате — любой, у кого есть ключ, может потратить ваш баланс.
- Разделяйте ключи по средам (один для продакшена, один для тестирования) и задайте лимит расходов для продакшен-ключа, чтобы ограничить масштаб возможного ущерба.
- Если вы подозреваете утечку, немедленно удалите ключ и создайте новый. Удаление вступает в силу сразу — вызовы со старым ключом получают 401.
- Чтобы предоставить кому-то временный доступ, создайте отдельный ключ с небольшим лимитом и удалите его после этого, вместо того чтобы делиться своим основным ключом.