Быстрый старт
API Delta Space управляет мониторами, SLO, инцидентами и расписаниями дежурств. Телеметрия принимается по OTLP на ingest.deltaspace.io.
1. Отправьте телеметрию
Настройте OTLP-экспортёр в приложении. Ключ приёма — в настройках проекта.
2. Создайте SLO
Укажите сервис, целевой уровень и окно расчёта. SLO появится на дашборде через минуту.
3. Настройте дежурство
Добавьте участников и график. Эскалация настраивается по шагам.
Все примеры используют переменную окружения DELTA_TOKEN. Не храните ключи в репозитории.
Аутентификация
Передавайте ключ в заголовке Authorization. Ключ привязан к проекту и роли:
для чтения достаточно read, для изменений — write.
curl -s https://api.deltaspace.io/v1/monitors \
-H "Authorization: Bearer $DELTA_TOKEN" \
-H "Accept: application/json"
Эндпоинты
Базовый адрес: https://api.deltaspace.io. Все ответы в JSON, коды ошибок описаны ниже.
/v1/monitorsСписок мониторов и их состояние.
/v1/sloСоздание SLO для сервиса.
/v1/incidentsИнциденты с таймлайном и участниками.
/v1/oncall/schedulesСоздание графика дежурств.
/v1/queryЗапрос метрик и логов за период.
Пример запроса
Создание объекта в регионе eu-central. Ответ содержит идентификатор и состояние обработки.
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, он полностью документирован.
История версий
v2.2 — текущая версия API. Совместима с предыдущей, изменения только аддитивные.
- Обновлены примеры и описания ошибок.
- Добавлены поля состояния и времени обновления.
- Delta 2.2: разборы инцидентов и эскалации — подробности релиза.
Помощь
Не нашли ответ? Поддержка отвечает в рабочие часы, а дежурный инженер — круглосуточно при инцидентах.
Написать в поддержку