GECKO.VPP
Developer/Webhooks

Webhooks

Push-сповіщення про події у вашому VPP-портфелі — без поллінгу. HMAC-SHA256 підпис у заголовку X-Gecko-Signature, ретраї з експоненційним відступом, доставка at-least-once.

Поки що webhooks у стадії розробки

Полінг через REST API уже працює — підпишіться нижче, щоб отримати раннє оповіщення про запуск push-доставки.

Типи подій

forecast.submitted

Прогноз генерації / навантаження подано до УкрЕнерго.

{
  "event": "forecast.submitted",
  "tenant_id": "11111111-1111-1111-1111-111111111111",
  "occurred_at": "2026-05-23T08:15:23+03:00",
  "data": {
    "submission_id": 4218,
    "date": "2026-05-24",
    "kind": "solar",
    "status": "submitted",
    "deadline_at": "2026-05-23T09:00:00+03:00"
  }
}
document.signed

Регуляторний документ підписано КЕП (демо-стуб у v2).

{
  "event": "document.signed",
  "tenant_id": "11111111-1111-1111-1111-111111111111",
  "occurred_at": "2026-05-23T11:42:01+03:00",
  "data": {
    "signed_doc_id": 91,
    "document_type": "REPORT",
    "signed_by": "operator@polyana.energy",
    "is_demo_stub": true
  }
}
instruction.ack

Диспетчерська інструкція підтверджена або відхилена оператором.

{
  "event": "instruction.ack",
  "tenant_id": "11111111-1111-1111-1111-111111111111",
  "occurred_at": "2026-05-23T13:01:55+03:00",
  "data": {
    "instruction_id": 7733,
    "state": "acknowledged",
    "operator_user_id": "u-12",
    "reason": "aFRR-up"
  }
}
optimisation.completed

Оптимізатор завершив прогін — є нові рекомендації setpoint-ів.

{
  "event": "optimisation.completed",
  "tenant_id": "11111111-1111-1111-1111-111111111111",
  "occurred_at": "2026-05-23T05:55:12+03:00",
  "data": {
    "optimisation_id": 552,
    "scenario": "day_ahead",
    "uplift_uah": "184320.50",
    "confidence": 0.78,
    "recommendations_count": 24
  }
}
setpoint.issued

Виписано новий setpoint на актив (УЗЕ заряд/розряд, СЕС обмеження).

{
  "event": "setpoint.issued",
  "tenant_id": "33333333-3333-3333-3333-333333333333",
  "occurred_at": "2026-05-23T14:00:00+03:00",
  "data": {
    "setpoint_id": 30911,
    "asset_id": 12,
    "effective_from": "2026-05-23T14:00:00+03:00",
    "effective_to": "2026-05-23T15:00:00+03:00",
    "target_power_mw": "-2.5",
    "target_soc_pct": "65.0",
    "reason": "arbitrage",
    "state": "issued"
  }
}
regulatory.event

З'явилася нова постанова НКРЕКП / повідомлення УкрЕнерго / ринкова подія.

{
  "event": "regulatory.event",
  "tenant_id": null,
  "occurred_at": "2026-05-23T09:00:00+03:00",
  "data": {
    "id": 12,
    "issuer": "НКРЕКП",
    "act_type": "Постанова",
    "act_number": "№ 871",
    "severity": "WARN",
    "category": "tariff",
    "title": "Зміна годинних кепів РДН для категорії «виробник»",
    "effective_at": "2026-06-01T00:00:00+03:00"
  }
}

Зареєструйтеся щоб отримати раннє оповіщення

Заповніть email + URL та оберіть події. Коли webhooks вийдуть з бети — ми відправимо тестовий пейлоад на вашу адресу.

Типи подій