ul-data-logger-api-sdk 3.3.3__tar.gz → 3.3.4__tar.gz

{ul_data_logger_api_sdk-3.3.3 → ul_data_logger_api_sdk-3.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ul-data-logger-api-sdk
-Version: 3.3.3
+Version: 3.3.4
 Summary: Data logger API sdk
 Author: Unic-lab
 License-Expression: MIT

{ul_data_logger_api_sdk-3.3.3 → ul_data_logger_api_sdk-3.3.4}/data_logger_api_sdk.py

@@ -25,6 +25,7 @@ from data_logger_api_sdk.types.api_base_stations import (
     ApiBaseStationSystemLogResponse,
     ApiBaseStationSystemLogsListResult,
 )
+from data_logger_api_sdk.types.api_bs_device_links import ApiBsDeviceLinkResponse, ApiBsDeviceLinksListResult
 from data_logger_api_sdk.types.api_bs_traffic_stats import ApiBsTrafficStatsResponse, ApiDeviceTrafficStatsQuery
 from data_logger_api_sdk.types.api_uplink_signal import (
     ApiDeviceUplinkSignalLatestResponse,
@@ -218,6 +219,29 @@ class DataLoggerApiSdk:
         )
         return ApiDeviceUplinkSignalsListResult(items=items, total_count=total_count)
 
+    def get_bs_device_links(
+        self,
+        start_at: datetime,
+        end_at: datetime | None = None,
+        limit: int = 500,
+        offset: int = 0,
+    ) -> ApiBsDeviceLinksListResult:
+        """GET /bs-device-links — связи «мак ↔ БС» за период («когда-либо» при start_at из далёкого прошлого).
+
+        Один запрос по журналу device_log (дистинкт по паре мак+БС) вместо
+        обхода всех БС; для ночного синка слоя «Объекты и устройства».
+        """
+        query: Dict[str, Any] = {"start_at": start_at.isoformat(), "limit": limit, "offset": offset}
+        if end_at is not None:
+            query["end_at"] = end_at.isoformat()
+        items, total_count = self._request_list_payload_once(
+            ApiMethod.GET,
+            "/bs-device-links",
+            List[ApiBsDeviceLinkResponse],  # type: ignore
+            query,
+        )
+        return ApiBsDeviceLinksListResult(items=items, total_count=total_count)
+
     def get_base_station(
         self,
         base_station_id: UUID,

{ul_data_logger_api_sdk-3.3.3 → ul_data_logger_api_sdk-3.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ul-data-logger-api-sdk"
-version = "3.3.3"
+version = "3.3.4"
 description = "Data logger API sdk"
 license = "MIT"
 requires-python = ">=3.14"

ul_data_logger_api_sdk-3.3.4/types/api_bs_device_links.py

@@ -0,0 +1,25 @@
+from typing import List, NamedTuple
+
+from pydantic import UUID4
+from ul_api_utils.api_resource.api_response import JsonApiResponsePayload
+
+
+class ApiBsDeviceLinkResponse(JsonApiResponsePayload):
+    """Связь «мак ↔ БС» за период: элемент ответа GET /bs-device-links.
+
+    Пара существует, если БС когда-либо получала пакет устройства в
+    запрошенном окне (дистинкт по журналу device_log). bs_id — идентификатор
+    БС Data Logger (у потребителя unified API это external_bs_id);
+    bs_identifier — её серийный номер.
+    """
+
+    device_network_mac: int
+    bs_id: UUID4
+    bs_identifier: str
+
+
+class ApiBsDeviceLinksListResult(NamedTuple):
+    """Результат спискового вызова: страница элементов и total_count."""
+
+    items: List[ApiBsDeviceLinkResponse]
+    total_count: int