Документація·Авторизація та 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)