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