API Application Programming Interface to interfejs umożliwiający automatyczną wymianę danych pomiędzy systemami informatycznymi, bez konieczności ręcznego eksportu czy importu plików.
API B METERS Readings
Umożliwia pobieranie danych z urządzeń pomiarowych - odczytów zużycia ciepła, wody oraz wskazań podzielników kosztów ogrzewania - bezpośrednio do systemu klienta, na trzech poziomach szczegółowości, wraz z danymi klientów.
API zbudowane jest zgodnie ze standardem OpenAPI w architekturze REST, co zapewnia szybką integrację. Każde połączenie wymaga autoryzacji za pomocą tokenu dostępu.
system
ONLINE
Dlaczego warto korzystać z API?
Dane bez wychodzenia z domu
Odczyty liczników, alarmy urządzeń oraz historia zużycia widoczne są w Twoim systemie na bieżąco - bez konieczności fizycznej wizyty w neiruchomości.
Dostępność 24/7
Dane są dostępne w dowolnym momencie, bez przestojów i ograniczeń godzinowych - Twój system pobiera je wtedy, kiedy potrzebuje.
Szybka wymiana danych
Połączenie odbywa się przez standardowe, zabezpieczone łącze internetowe - nie wymaga dedykowanej infrastruktury ani skomplikowanej konfiguracji po Twojej stronie.
Jeden interfejs, wszystkie urządzenia
Niezależnie od tego, czy integrujesz wodomierze, ciepłomierze czy podzielniki kosztów ogrzewania - korzystasz z jednego, spójnego interfejsu API.
Integracja w 1–2 dni
Standardowa integracja zajmuje zaledwie 1–2 dni robocze. Nasz zespół wspiera Cię na każdym etapie - od pierwszego kontaktu po uruchomienie produkcyjne.
Mniej pracy ręcznej, mniej pomyłek
Dane trafiają do Twojego systemu automatycznie, więc nie musisz ich ręcznie przepisywać ani importować z plików - to oszczędność czasu Twojego zespołu i eliminacja błędów.
Łatwe skalowanie
System można łatwo rozszerzać o kolejne budynki i urządzenia. Rozbudową integracji zajmuje się B METERS, bez dodatkowych prac po stronie klienta.
Zgodność z przepisami
Od 1 stycznia 2027 r. wszystkie ciepłomierze, podzielniki kosztów ogrzewania i wodomierze ciepłej wody w budynkach wielolokalowych muszą mieć funkcję zdalnego odczytu (nowelizacja ustawy Prawo energetyczne wdrażająca unijną dyrektywę EED). Ta sama ustawa nakłada też obowiązek nieodpłatnego, comiesięcznego informowania mieszkańców o ich zużyciu. Integracja z naszym API pozwala spełnić oba te obowiązki bez budowania własnej infrastruktury odczytowej od zera.
Kroki do integracji API
Potrzebujesz pomocy?Skontaktuj się z zespołem B METERSw sprawie konfiguracji dostępu do API.
Jak działa HYDROLINK ONLINE ?
Od licznika w mieszkaniu po Twój system przez API — zobacz całą ścieżkę danych. Kliknij na pojęcie z listy obok, aby poznać jego znaczenie.
Powiększ obraz (uszczypnij ekran), aby zobaczyć wszystkie szczegóły diagramu.
HYDRODIGIT-S1 COMBO — wodomierz elektroniczny ze zintegrowanym modułem transmisji wM-Bus i LoRaWAN, wysoka klasa dokładności.
HYDRODIGIT-M1 COMBO — wodomierz elektroniczny ze zintegrowanym modułem transmisji radiowej wM-Bus i LoRaWAN
HYDROCAL-M4 RADIO — kompaktowy ciepłomierz ze zintegrowanym modułem wM-Bus i LoRaWAN, do mieszkań i małych domów.
HYDROCLIMA-2 — dwuczujnikowy podzielnik kosztów ogrzewania z wbudowanym modułem radiowym wM-Bus.
GSD8-I + moduł IWM-TX5 — wodomierz suchobieżny, wyposażony w 8-bębenkowe liczydło oraz interfejs indukcyjny, przystosowany do montażu modułu zdalnego odczytu.
GSD8-RFM + moduł RFM-TX1.1 IP65/IP68 — wodomierz suchobieżny, wyposażony w 8-bębenkowe liczydło i interfejs optyczny, przystosowany do montażu modułu zdalnego odczytu.
wM-Bus - Standard komunikacji radiowej, który pozwala licznikom bezprzewodowo wysyłać dane o zużyciu do urządzenia odbiorczego
Bezprzewodowa transmisja danych na duże odległości (do ok. 5 km) przy bardzo niskim poborze energii. W zabudowie jednorodzinnej liczniki wysyłają odczyty do wspólnej bramki obsługującej całe osiedle.
Standard transmisji komórkowej (4G), którym koncentrator lub bramka łączy się z portalem — działa jak zwykła karta SIM, bez dodatkowego okablowania czy Wi-Fi w budynku.
Urządzenie instalowane w budynku wielolokalowym, które zbiera dane ze wszystkich modułów (wodomierzy, ciepłomierzy, podzielników) i przesyła je bezpośrednio do portalu HYDROLINK ONLINE.
Zbiera sygnał LoRaWAN z liczników rozproszonych w wielu domach jednorodzinnych na danym obszarze i przekazuje dane zbiorczo do portalu przez sieć GSM (LTE) — jedna bramka może obsłużyć całe osiedle.
Portal B METERS gromadzący dane ze wszystkich podłączonych urządzeń. Umożliwia zdalny odczyt, wizualizację historii zużycia i eksport danych bez wizyty w budynku. Umożliwia także mieszkańcom pogląd swojego zużycia mediów.
Interfejs programistyczny, dzięki któremu systemy zewnętrzne — rozliczeniowe, PEC, wodociągi czy smart home — mogą automatycznie pobierać dane odczytowe z portalu po uprzedniej weryfikacji za pomocą tokenu.
API udostępnia dane w 3 zakresach:
| Zakres danych | Basic | Medium | Extended |
|---|---|---|---|
| Miasto, nazwa ulicy, klatka, nr lokalu | |||
| Numer urządzenia | |||
| Aktualne wskazanie na wybrany dzień | |||
| Alarmy | — | ||
| Wartości historyczne (do 12 miesięcy wstecz) | — | — |
Z czym można integrować?
Wybierz obszar, żeby zobaczyć, jak dane z API łączą się z innymi systemami.
Integracja z programami czynszowymi i rozliczeniowymi
Dane odczytowe z HYDROLINK ONLINE trafiają przez API bezpośrednio do systemu, w którym rozliczasz czynsz i media — bez ręcznego przepisywania wskazań z jednego programu do drugiego.
API robi pracę za Ciebie
Odczyt trafia z HYDROLINK ONLINE prosto do systemu rozliczeniowego — szybko, automatycznie i bez przepisywania danych.
Automatyczny eksport
Wskazania liczników są przekazywane bezpośrednio do systemu rozliczeniowego.
Mniej błędów
Automatyczny przepływ danych ogranicza pomyłki przy ręcznym przepisywaniu odczytów.
Wiele systemów
Otwarte API pozwala współpracować z różnymi programami czynszowymi i rozliczeniowymi.
Programy, z którymi współpracujemy
Integracje przez API
UNISOFT
System dla spółdzielni mieszkaniowych i zarządców nieruchomości — odczyty z HYDROLINK ONLINE trafiają wprost do modułu rozliczeń mediów.
Mieszczanin
Program dla spółdzielni i wspólnot mieszkaniowych — integracja automatycznie zasila rozliczenia zużycia danymi z liczników.
Kolejne integracje
Pracujemy nad połączeniem z kolejnymi programami czynszowymi i rozliczeniowymi.
Integracja ze smart home — odczyt i sterowanie w jednym miejscu
Licznik z modułem radiowym to nie tylko odczyt zużycia. Podłączony do aplikacji smart home mieszkaniec widzi tam wskazania wody i ciepła, a jednocześnie steruje ogrzewaniem, czujnikami i innymi połączonymi urządzeniami w domu. Różne systemy łączą się w jedno, spójne doświadczenie smart mieszkania.
PODGLĄD APLIKACJI
Zużycie i dane w jednym miejscu
W aplikacji mieszkaniec ma szybki podgląd wskazań liczników i bieżącego zużycia.
Więcej niż sam odczyt
Połączenie danych z liczników z aplikacją smart home pozwala stworzyć jedno, spójne miejsce do monitorowania mieszkania i zarządzania jego funkcjami.
Odczyt i sterowanie w jednym miejscu
Zamiast osobnej aplikacji do sprawdzania zużycia i osobnej do sterowania domem, mieszkaniec ma jeden, wspólny widok.
Dane na bieżąco
Wskazania liczników trafiają do aplikacji smart home automatycznie, bez ręcznego wprowadzania odczytów.
Alarmy tam, gdzie mieszkaniec zagląda
Informacja o wycieku czy nietypowym zużyciu pojawia się w tej samej aplikacji, z której korzysta na co dzień.
Otwarta integracja przez API
Dane z liczników mogą zasilać danymi różne systemy smart home obsługujące otwarte API.
Integracja dla wodociągów
Najważniejsza korzyść jest prosta: dane z portalu HYDROLINK ONLINE trafiają przez API prosto do systemu przedsiębiorstwa — razem z alarmami o wyciekach, przepływie wstecznym czy próbach ingerencji w licznik. Nie trzeba nikogo wysyłać w teren, żeby to sprawdzić.
Dane wprost z portalu
Odczyty z HYDROLINK ONLINE trafiają przez API prosto do systemu przedsiębiorstwa — bez eksportów ręcznych.
Alarmy razem z odczytem
Informacje o przepływie wstecznym, ciągłym przepływie czy próbie ingerencji trafiają do systemu razem z danymi zużycia.
Wireless M-Bus 868 MHz
Szyfrowana transmisja zgodna z PN-EN 13757 — kompatybilna z urządzeniami w standardzie OMS.
Integracja z automatyką kotłowni i węzłów cieplnych
Ciepłomierze B METERS z modułem zdalnego odczytu przekazują przez API dane, które można wykorzystać w systemach zarządzania kotłownią (BMS) — do bilansowania ciepła między węzłem a lokalami.
Ciepłomierze
Zdalny odczyt zużycia ciepła z modułami wM-Bus lub LoRaWAN, z danymi o temperaturze zasilania i powrotu.
Bilansowanie ciepła
Porównanie licznika głównego z sumą liczników lokalowych pozwala szybko wychwycić straty na przesyle.
Dane jako wsad do automatyki
Odczyty przez API mogą zasilać system BMS sterujący pracą węzła cieplnego.
Podzielniki HYDROCLIMA
Tam, gdzie nie ma liczników lokalowych, uzupełniają dane o rozkładzie zużycia ciepła.