BeeHUB logo
BeeHUB MENU GŁÓWNE
ZalogujZarejestruj się teraz!
BeeHUB AppIntelligent Hives Sp. z o.o.office@intelligenthives.eu

IoT BeeHUB API v1

Platforma BeeHUB

Publiczne REST API

BeeHUB udostępnia publiczne API telemetryczne dla zespołów badawczych, programów smart city i projektów data science. Dane historyczne są dostępne przez udokumentowane endpointy publiczne, a integracje prywatne i partnerskie korzystają z dedykowanych zakresów dostępu.

Serwer API https://api.intelligenthives.eu
Wersjav1
Kompilacja1.0.0-build.20260602.t1230
Kontakt office@intelligenthives.eu
  • Urządzenia BeeHUB mogą publikować zanonimizowane dane dla projektów badawczych i smart city.
  • Partnerzy mogą podłączyć prywatne urządzenia do BeeHUB Cloud po otrzymaniu danych konfiguracyjnych.
  • Mikroserwisy BeeHUB AI przetwarzają telemetrię w czasie rzeczywistym i udostępniają archiwa systemom zewnętrznym.
Infrastruktura chmurowa BeeHUB obsługująca API telemetryczne
Lista kontrolna integracji

Zanim zaczniesz

Stosuj te zasady podczas integrowania danych BeeHUB ze swoimi aplikacjami.

  • Sprawdź typ API i poziom dostępu. Endpointy publiczne udostępniają telemetrię historyczną; endpointy partnerskie wymagają dodatkowych uprawnień.
  • Chroń prywatne urządzenia dedykowanym tokenem. Nigdy nie umieszczaj danych logowania BeeHUB w aplikacjach klienckich.
  • Dla dużych zbiorów używaj stronicowania i w miarę możliwości buforuj odpowiedzi. Znaczniki czasu mają format ISO 8601 UTC.
Główne endpointy

Dostęp do danych publicznych

Pobieraj archiwa telemetrii, podsumowania analiz i najnowsze publiczne odczyty przez poniższe endpointy.

GET

/api/data/public-measurements

Pobiera historyczne próbki telemetrii z publicznych urządzeń BeeHUB.

Id DateFrom DateTo Page PerPage RequestedPerPage OrderBy Descending Filter
200 OK - stronicowane pomiary JSON.
GET

/api/data/public-analysis

Pobiera zagregowane analizy wygenerowane przez procesy BeeHUB AI.

DeviceId DateFrom DateTo
200 OK - podsumowanie analityczne.
POST

/api/data/public-measurements/last/batch

Pobiera najnowsze publiczne pomiary wielu urządzeń w jednym żądaniu.

deviceIds includeLocation
200 OK - pakiet najnowszych pomiarów.
GET

/api/devices/public-analysis/{deviceId}

Zwraca najnowsze podsumowanie analizy AI dla wybranego urządzenia BeeHUB.

deviceId
200 OK - raport pojedynczego urządzenia.
Potrzebujesz więcej?

Integracje enterprise i dostęp do sandboxa

Potrzebujesz strumieni WebSocket, tematów MQTT lub zdalnego provisioningu? Dobierzemy plan integracji BeeHUB do projektu i uruchomimy rozszerzone zakresy API, dane live oraz niestandardową analitykę.

Skontaktuj się z zespołem BeeHUB Utwórz konto BeeHUB
Prywatne endpointy

Dostęp do prywatnych danych pomiarowych

Uwierzytelnione endpointy dla urządzeń przypisanych do konta, dashboardów i integracji partnerskich.

GET

/api/data/measurements

Odczytuje uwierzytelnioną historię pomiarów prywatnych urządzeń BeeHUB przypisanych do konta.

Id DateFrom DateTo Page PerPage RequestedPerPage OrderBy Descending Filter
200 OK - stronicowane prywatne pomiary. Prywatne ID
GET

/api/data/measurements/timeseries

Zwraca szeregi czasowe gotowe do wykresów z wybranymi metrykami, próbkowaniem i agregacją.

CurrentUserId DeviceId From To Metrics Preset Sample Aggregate LimitPoints Cursor
200 OK - odpowiedź szeregu czasowego. Prywatne ID
GET

/api/data/measurements/capabilities

Wykrywa dostępne kanały pomiarowe i możliwości prywatnego urządzenia.

CurrentUserId DeviceId
200 OK - możliwości urządzenia. Prywatne ID
GET

/api/data/measurements/location-path

Odczytuje historyczną trasę GPS urządzeń BeeHUB z lokalizatorem.

CurrentUserId DeviceId From To Sample LimitPoints
200 OK - trasa lokalizacji. Prywatne ID
GET

/api/data/measurements/last

Pobiera najnowszy odczyt pomiarowy prywatnego urządzenia.

Id
200 OK - najnowszy pomiar. Prywatne ID
POST

/api/data/measurements/last/batch

Pobiera najnowsze pomiary dla wybranego zestawu prywatnych urządzeń.

deviceIds includeLocation
200 OK - pakiet najnowszych pomiarów. Prywatne ID
POST

/api/data/measurements/last/bulk

Pobiera zbiorczo najnowsze pomiary dla dashboardów i integracji prywatnych urządzeń.

deviceIds includeLocation
200 OK - zbiorcza odpowiedź najnowszych pomiarów. Prywatne ID
Rozpocznij czat na WhatsApp