К содержимому

Аутентификация API ключа: заголовки и ротация

Передавайте ключ в Authorization: Bearer или x-api-key и не передавайте оба заголовка без причины.

Заголовки и ограничения

Ключ передают в заголовке Authorization: Bearer или x-api-key. Если пришли оба, шлюз читает только Authorization. Ключ ограничивают моделями, сроком, расходом за всё время, за день и за месяц и числом запросов в минуту. GET /v1/key показывает, какой ключ использует процесс и какие ограничения на нём действуют. Полный ключ показывается один раз при создании, на аккаунт можно завести до 50 ключей, включённых и выключенных.

Ротация ключа

Создайте новый ключ, обновите секрет в среде, перезапустите процессы и отзовите старый ключ после проверки. Так запросы не останавливаются в момент замены. Встроенная ротация делает то же самое с окном совместимости: старый ключ продолжает работать до 24 часов по вашему выбору, лимиты и статистика общие. Выключение ключа вступает в силу в течение минуты.

Открыть ключи

Храните ключ в секрете

Ключ передавайте только через переменные окружения. Полный ключ не вставляйте в браузерный код, логи и сообщения поддержки.
Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key