Аутентификация
Получение и использование API-ключей для работы с Premiss Cloud API
Обзор
Все запросы к Premiss Cloud API требуют аутентификации через API-ключ. Ключ передаётся в заголовке Authorization каждого запроса.
Получение API-ключа
- Зарегистрируйтесь в Premiss Cloud
- Перейдите в Управление API-ключами
- Нажмите Создать ключ
- Скопируйте ключ — он показывается только один раз
Ключ начинается с sk- и показывается только при создании. Сохраните его в безопасном месте. Если ключ утерян, создайте новый.
Использование ключа
Передавайте ключ в заголовке Authorization с префиксом Bearer:
Безопасность
- Не храните ключи в коде или git-репозиториях
- Используйте переменные окружения:
PREMISS_API_KEY - Каждый ключ привязан к вашему аккаунту и тарифу
- Неактивные ключи можно отозвать в личном кабинете
- Ключи имеют настраиваемый срок действия
Ошибки аутентификации
| HTTP | Код | Описание |
|---|---|---|
401 | MISSING_API_KEY | Отсутствует заголовок Authorization |
401 | INVALID_AUTH_FORMAT | Неверный формат (нет префикса Bearer) |
401 | INVALID_API_KEY | API-ключ невалиден |
401 | API_KEY_EXPIRED | Срок действия ключа истёк |
429 | RATE_LIMIT_EXCEEDED | Превышен лимит запросов |