http: api: devices: add optional filter by site id

Author: rnovatorov

src/enapter/cli/http/api/device_list_command.py

@@ -41,6 +41,7 @@ def register(parent: cli.Subparsers) -> None:
             action="store_true",
             help="Expand device communication information",
         )
+        parser.add_argument("-s", "--site-id", help="Filter devices by site ID")
 
     @staticmethod
     async def run(args: argparse.Namespace) -> None:
@@ -52,6 +53,7 @@ async def run(args: argparse.Namespace) -> None:
                 expand_properties=args.properties,
                 expand_connectivity=args.connectivity,
                 expand_communication=args.communication,
+                site_id=args.site_id,
             ) as stream:
                 count = 0
                 async for device in stream:

src/enapter/http/api/devices/client.py

@@ -101,8 +101,9 @@ async def list(
         expand_properties: bool = False,
         expand_connectivity: bool = False,
         expand_communication: bool = False,
+        site_id: str | None = None,
     ) -> AsyncGenerator[Device, None]:
-        url = "v3/devices"
+        url = "v3/devices" if site_id is None else f"v3/sites/{site_id}/devices"
         expand = {
             "manifest": expand_manifest,
             "properties": expand_properties,