API

API: автентифікація

Як створити ключі API, автентифікувати запити, базова адреса, версії та права доступу ключів.

Базова адреса

https://app.tenium.app/api/v1

Усі відповіді надходять у форматі JSON. Часові позначки — ISO 8601 в UTC. Ідентифікатори — UUID.

Ключі API

Налаштування → Ключі API → Новий ключ. Ключ показується лише один раз. У кожного ключа є рівень доступу:

• read: перегляд списків і даних моніторів, інцидентів, перевірок, сторінок статусу. Доступний на всіх тарифах.
• write: створення, зміна й видалення. Pro та Agency.
• Ключі, створені клієнтом з доступом лише для перегляду, обмежені його простором клієнта.

Автентифікація

Передавайте ключ як bearer-токен:

curl -H "Authorization: Bearer tn_live_3f9a..." https://app.tenium.app/api/v1/monitors

Версії

Шлях містить основну версію (v1). Зворотно сумісні доповнення (нові поля, нові ендпоінти) з’являються без зміни версії. Несумісні зміни виходять у новій основній версії, а стара працює ще щонайменше 6 місяців.

Пагінація

Ендпоінти зі списками приймають limit (за замовчуванням 50, максимум 200) і cursor. Якщо результатів більше, у відповіді є nextCursor.

{ "data": [ ... ], "nextCursor": "eyJpZCI6..." }

Ідемпотентність

Запити POST приймають заголовок Idempotency-Key. Якщо повторити запит із тим самим ключем протягом 24 годин, ви отримаєте початкову відповідь.