Ротация постоянного apiKey (обновление токена)

Обновлено 18 августа 2026

Описание: обновление постоянного apiKey и refreshToken до истечения их срока действия. Позволяет бесшовно продлить доступ к API.

Последовательность шагов

1. Подготовить запрос — использовать действующий постоянный apiKey (в заголовке Authorization) и текущий refreshToken (в теле запроса).
2. Отправить запрос на ротацию через POST /api/v1/api-keys/refresh с параметром refreshToken в теле запроса.
3. Сохранить параметры нового ответа:
   • apiKey — новый постоянный apiKey партнера
   • apiKeyExpiresAt — новая дата истечения постоянного apiKey
   • refreshToken — новый токен для последующей ротации
   • refreshTokenExpiresAt — новая дата истечения refreshToken
4. Использовать новый apiKey для всех рабочих запросов.

Важные особенности

• После успешной ротации старый refreshToken помечается как использованный и больше недействителен.
• Старый apiKey продолжает действовать 10 минут (grace period) для сглаживания переключения — это позволяет избежать ошибок во время переключения на новый ключ.
• Рекомендуется инициировать ротацию за несколько дней до истечения текущего apiKey.

Альтернативные сценарии ошибок

Код ошибки	Описание
apiKey.invalid.error	Постоянный apiKey не найден или недействителен
header.invalid.error	Заголовок Authorization не передан