Перейти к содержимому
DieselCloud
ВойтиЗапросить демо
ПлатформаAPI

REST API
DieselCloud

Полный программный доступ к данным ваших генераторов.
JSON. HTTPS. OAuth 2.0.

Документация API Получить API-ключ
Response · 200 OK
GET /api/v1/generators
{
"data": [
{
"id": "dgu-1",
"name": "Cummins C150D5",
"status": "online",
"fuel_level_pct": 78,
"power_kw": 95.2,
"runtime_hours": 1847
}
]
}

Возможности API

Получить данные

Текущие параметры генераторов, историческая телеметрия, статусы, алерты. В реальном времени или за период.

Webhook-уведомления

Подписка на события: аварии, алерты, изменения статуса. Push-уведомления на ваш сервер.

Управление

Создание и редактирование территорий, генераторов, пользователей, настроек алертов через API.

Интеграция

Подключение к 1С, ERP, BI, СКАДА, Helpdesk — через стандартные HTTP-запросы.

Основные эндпоинты

МетодЭндпоинтОписание
GET/api/v1/generatorsСписок всех генераторов с текущими параметрами
GET/api/v1/generators/{id}Детальная информация по конкретному генератору
GET/api/v1/generators/{id}/telemetryИсторическая телеметрия за период (fuel, power, temp…)
GET/api/v1/generators/{id}/alertsАлерты по генератору
GET/api/v1/alertsВсе алерты по парку с фильтрацией
POST/api/v1/alerts/{id}/acknowledgeПодтверждение (принятие) алерта
GET/api/v1/territoriesСписок территорий с генераторами
GET/api/v1/reports/fuelОтчёт по расходу топлива за период
POST/api/v1/webhooksСоздание webhook-подписки на события
GET/api/v1/controllersСписок поддерживаемых контроллеров и их параметров

Полная документация API с примерами запросов и ответов — в Swagger/OpenAPI спецификации.

Примеры использования

Python
import requests
 
API_KEY = "your_api_key"
BASE = "https:">//api.diesel-cloud.ru/v1"
 
"color:#6A9955"># Получить все генераторы
resp = requests.get(
    f"{BASE}/generators",
    headers={"Authorization": f"Bearer {API_KEY}"}
)
generators = resp.json()["data"]
 
for gen in generators:
    print(f"{gen['name']}: {gen['status']}, "
          f"Топливо: {gen['fuel_level_pct']}%")

Webhook-события

СобытиеОписание
generator.status_changedИзменился статус генератора (online → offline, normal → critical)
alert.createdСоздан новый алерт (авария, аномалия, предупреждение)
alert.acknowledgedАлерт принят оператором
alert.resolvedАлерт закрыт (проблема решена)
telemetry.threshold_exceededПараметр превысил настроенный порог
maintenance.dueПриближается плановое ТО

Аутентификация и лимиты

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

OAuth 2.0 (Bearer token)
API-ключи для серверных интеграций
JWT для пользовательских сессий
Все запросы — только HTTPS
Authorization: Bearer eyJhbGci...

Лимиты

1 000запросов/минСтандартный тариф
5 000запросов/минТариф Предприятие
90днейИсторическая телеметрия за один запрос
10подписокWebhook на аккаунт

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

1С: Бухгалтерия

Автоматическая выгрузка данных о расходе топлива в 1С для списания ГСМ. Ежемесячно или в реальном времени.

Смотреть руководство

СКАДА (OPC UA)

Передача данных из DieselCloud в существующую СКАДА-систему. Статусы, параметры, алерты — в привычном интерфейсе.

Смотреть руководство

Telegram Bot (custom)

Создайте собственного бота на основе Webhook-уведомлений. Кастомные команды, отчёты по запросу.

Смотреть руководство

Готовы интегрироваться?

Получите API-ключ и начните работу с данными генераторов за считанные минуты

Получить API-ключ Читать документацию