Документация·Авторизация и API-ключи
🔑

Авторизация и API-ключи

Bearer-токены, ротация ключей, IP allowlist и ошибки что вы увидите при неудачной авторизации.

Bearer-токены

Каждый запрос к https://api.eveses.com несёт API-ключ как bearer-токен:

Authorization: Bearer 17|aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcd

Ключи создаются в Account → API Keys. Относитесь к ним как к паролям — они дают полный доступ к балансу, активациям и аренде.

Создание

Нажмите New key, дайте label (local-dev, ci, production-eu). Токен показывается один раз при создании — сразу сохраните.

Ротация

Ключи не редактируются. Чтобы ротировать: создайте новый → подставьте в деплой → удалите старый. Удаление мгновенное.

IP allowlist

Per-key allowlist: привяжите ключ к конкретным IP / CIDR. Запросы вне списка получают 403. Настройка на странице ключа.

Scopes

Все ключи сейчас дают полный доступ. Scope-ограниченные ключи (read-only, rentals-only) — в roadmap.

Ошибки

HTTP Что значит
401 Нет или сломан Authorization
403 Ключ отозван, аккаунт заблокирован, или IP не в allowlist
429 Превышен per-key rate limit (default 60 rpm)