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 часов, вы получите исходный ответ.