Огляд

API Atenuk

Керуй своїми донатами, статистикою та цілями через простий REST API. Все в JSON. Авторизація через Bearer-токен.

Base URL
https://api.atenuk.fun
Endpoints
6 ручок
Формат
JSON / REST
Авторизація

Bearer Token

Передавай заголовок Authorization у кожному запиті. Є два режими — TEST (публічний, демо-дані) та LIVE (реальні дані).

TEST режим
Демо-дані

Тільки client_id — отримуєш мокові дані. Ідеально для розробки.

Authorization: Bearer YOUR_CLIENT_ID
LIVE режим
Реальні дані

client_id.client_secret — справжні дані акаунта. Тримай secret тільки на сервері.

Authorization: Bearer ID.SECRET
Не світіть client_secret. Якщо протік — регенеруйте в кабінеті.
Кабінет

Мої API-ключі

Керуй доступом до свого API. Максимум 10 активних ключів.

Потрібен акаунт

Щоб створювати API-ключі — увійдіть у свій акаунт Atenuk.

Захист

Ліміти запитів

Два рівні: на ключ і на IP. Захищає і тебе, і сервіс.

Скоуп
Ліміт
Вікно
Один ключ
60 req
60 сек
Один IP
120 req
60 сек
Заголовки відповіді
X-RateLimit-Limit Максимум запитів у вікні
X-RateLimit-Remaining Залишилось запитів
X-RateLimit-Reset Через скільки сек скинеться
Retry-After При 429 — коли повторити
Обробка помилок

Помилки

Усі помилки повертаються у єдиному форматі з кодом, повідомленням та підказкою.

{
  "error": {
    "code": "invalid_token",
    "message": "Невірний client_secret",
    "hint": "Перевірте client_id та client_secret"
  }
}
Код
HTTP
Опис
unauthorized
401
Немає або невірний Authorization
invalid_token
401
Ключ не знайдено або secret невірний
expired_token
401
Термін дії ключа вийшов
revoked_token
401
Ключ відкликано
forbidden
403
Доступ заборонено
not_found
404
Ресурс не знайдено
rate_limited
429
Перевищено ліміт запитів
internal_error
500
Помилка на сервері

Дивитись всі endpoints

Повна документація з прикладами, схемами та пісочницею

Відкрити документацію