Быстрый старт — API‑ключи

Что такое API‑ключ

API‑ключ — это секретный токен, который идентифицирует ваше приложение в платформе. Все запросы к публичному proxy API RouterAPI должны быть подписаны валидным ключом, иначе они будут отклонены.

Ключ:

• связывается с вашим аккаунтом и проектом;
• участвует в биллинге и статистике потребления;
• может иметь отдельные лимиты и права доступа.

Создание API‑ключа

1. Откройте раздел «API‑ключи» в личном кабинете.
2. Нажмите «Создать ключ».
3. При необходимости задайте:
   • название (например, backend-production, worker-staging);

Где используется API‑ключ

Ключ передаётся во внешний API так:

Authorization: Bearer YOUR_API_KEY

Этот заголовок используется, в частности, для следующих публичных маршрутов:

• GET https://routerapi.ru/api/v1/key
• GET https://routerapi.ru/api/v1/models
• POST https://routerapi.ru/api/v1/chat/completions

Ротация и отзыв ключей

• Ротация: при регулярной ротации создайте новый ключ, переведите на него трафик, затем удалите старый.
• Компрометация: если ключ мог утечь, немедленно отзовите его в кабинете и создайте новый.

Отозванный ключ перестаёт принимать запросы, но остаётся в отчётности за прошлые периоды.

Рекомендации по безопасности

• Никогда не вшивайте ключ в фронтенд‑код или мобильные приложения.
• Храните ключи в переменных окружения, менеджерах секретов или конфигурации сервера.
• Ограничивайте права и лимиты ключей по принципу минимально необходимого доступа.
• Используйте разные ключи для development, staging и production.

Подробнее о безопасной работе с ключами читайте в разделе «Аутентификация и безопасность».