GECKO.VPP
Live demo/producer

Розробникам GECKO VPP — API + SDK + Webhooks

Програмний доступ до тих самих даних, що бачать виробники, бізнес та власники УЗЕ у своїх кабінетах. RESTful, multi-tenant через заголовок X-Tenant-Id, OpenAPI 3.1, типобезпечні SDK.

API Explorer

Інтерактивна документація OpenAPI 3.1 з пробою всіх 35+ ендпоінтів.

Відкрити Scalar

TypeScript SDK

Thin-wrapper над fetch, типи з OpenAPI, працює у Node 20+ та Bun.

npm install

Python SDK

httpx-обгортка для CPython 3.11+, працює в скриптах та Jupyter.

pip install

Webhooks

Push-події про підпис документів, оптимізації, інструкції. Beta.

Дивитися події

Швидкий старт

Кілька рядків — і у вас список активів портфеля.

import { GeckoVPPClient } from "@gecko-vpp/sdk-ts";

const client = new GeckoVPPClient({
  baseURL: "http://localhost:8000",
  tenantId: "11111111-1111-1111-1111-111111111111",
});

const assets = await client.assets.list();
console.log(`Знайдено ${assets.length} активів`);

Як отримати tenant UUID?

  1. У продакшені — реєструєтесь, верифікуєте КЕП, отримуєте власний UUID.
  2. У цьому демо доступу не треба — використовуйте один з трьох публічних демо-tenant'ів нижче.
  3. Передавайте UUID у заголовку X-Tenant-Id на кожний запит.

Демо tenant UUID

  • Поляна Енерго · СЕС + УЗЕ — виробник ВДЕ
    11111111-1111-1111-1111-111111111111
  • Карпатський завод · Активний споживач (C&I)
    22222222-2222-2222-2222-222222222222
  • БСЗ Захід-1 · Власник УЗЕ (storage)
    33333333-3333-3333-3333-333333333333

Архітектура GECKO VPP

Хаб-і-спиці: 4 ринкові сервіси, 4 типи учасників. Усі шляхи дотепер ведуть до одного API.

Відкрити діаграму
github.com/basisabp1984/gecko-vpp-rebuild