API v2.2

Быстрый старт

API Delta Space управляет мониторами, SLO, инцидентами и расписаниями дежурств. Телеметрия принимается по OTLP на ingest.deltaspace.io.

1. Отправьте телеметрию

Настройте OTLP-экспортёр в приложении. Ключ приёма — в настройках проекта.

2. Создайте SLO

Укажите сервис, целевой уровень и окно расчёта. SLO появится на дашборде через минуту.

3. Настройте дежурство

Добавьте участников и график. Эскалация настраивается по шагам.

Все примеры используют переменную окружения DELTA_TOKEN. Не храните ключи в репозитории.

Аутентификация

Передавайте ключ в заголовке Authorization. Ключ привязан к проекту и роли: для чтения достаточно read, для изменений — write.

terminal — проверка ключа
curl -s https://api.deltaspace.io/v1/monitors \
  -H "Authorization: Bearer $DELTA_TOKEN" \
  -H "Accept: application/json"

Эндпоинты

Базовый адрес: https://api.deltaspace.io. Все ответы в JSON, коды ошибок описаны ниже.

GET
/v1/monitors

Список мониторов и их состояние.

POST
/v1/slo

Создание SLO для сервиса.

GET
/v1/incidents

Инциденты с таймлайном и участниками.

POST
/v1/oncall/schedules

Создание графика дежурств.

GET
/v1/query

Запрос метрик и логов за период.

Пример запроса

Создание объекта в регионе eu-central. Ответ содержит идентификатор и состояние обработки.

terminal — create
curl -s -X POST https://api.deltaspace.io/v1/monitors \
  -H "Authorization: Bearer $DELTA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "first", "region": "eu-central"}'

Ошибки

Ошибки возвращаются с машиночитаемым полем code и человекочитаемым message.

401Ключ приёма отсутствует или истёк.
403Нет доступа к проекту.
422Некорректный SLO: цель должна быть ниже 100%.
429Превышен лимит запросов: 1 200 в минуту.

SDK и интеграции

Официальные SDK и готовые коннекторы. Если нужного нет — используйте HTTP API, он полностью документирован.

OpenTelemetryPrometheusGrafanaSlackPagerDutyJiraGitHubTelegram

История версий

v2.2 — текущая версия API. Совместима с предыдущей, изменения только аддитивные.

Помощь

Не нашли ответ? Поддержка отвечает в рабочие часы, а дежурный инженер — круглосуточно при инцидентах.

Написать в поддержку
Действие выполнено