Доступно

API-ключи: создание, ограничения и безопасное хранение

Как создать и защитить ключ Токенмоста, настроить бюджет и RPM, заменить скомпрометированный секрет и диагностировать 401.

API Токенмоста работает

Базовый адрес — https://tokenmost.ru/v1. Создайте ключ в личном кабинете, выберите модель в каталоге и отправьте первый запрос. Методы, которые ещё не доступны, отмечены отдельно.

Как это устроено

API-ключ связывает запросы с вашим аккаунтом и бюджетом. Создавайте отдельный ключ для каждого приложения и окружения: это упрощает контроль расходов, замену и отзыв без остановки других сервисов.

Что потребуется

  • Положительный доступный баланс: при нулевом балансе создание ключа закрыто.
  • Понимание, какое приложение и окружение будет использовать ключ.

Порядок работы

  1. Откройте «API-ключи» в кабинете и нажмите «Новый ключ».
  2. Укажите понятное имя, срок действия, общий бюджет, разрешённый API и RPM.
  3. Скопируйте секрет при создании и сразу сохраните его в менеджере секретов или переменной окружения.
  4. Выполните короткий запрос и проверьте дату последнего использования и расход в строке ключа.
  5. При утечке сначала отзовите ключ, затем создайте замену и обновите приложение.

Готовая конфигурация

Проверка ключа без платной генерации

curl "https://tokenmost.ru/v1/balance" \
  -H "Authorization: Bearer $TOKENMOST_API_KEY"

Что учесть

Полное значение секрета показывается только в момент создания. В списке остаётся маска, по которой ключ можно отличить от других.

Бюджет и RPM

Бюджет ограничивает общий расход конкретного ключа, RPM — число запросов в минуту. Эти ограничения дополняют баланс аккаунта: запрос проходит только когда хватает и баланса, и бюджета ключа.

Где нельзя хранить ключ

Не помещайте секрет в браузерный JavaScript, мобильную сборку, URL, репозиторий, тикет или скриншот. Публичный интерфейс должен обращаться к вашему серверу, а сервер добавляет Authorization.

Ошибки и диагностика

Кнопка создания недоступна

Пополните баланс: ключи создаются только при положительном доступном остатке.

HTTP 401 сразу после замены

Убедитесь, что процесс приложения перечитал переменную окружения и отправляет новый ключ.

Ключ работает локально, но не на сервере

Проверьте секрет окружения именно запущенного процесса, без вывода полного значения в журнал.

Запросы внезапно остановились

Проверьте срок действия, остаток бюджета, RPM, статус ключа и баланс аккаунта.

Источники и связанные инструкции

Читайте дальше

← Все инструкции