feat(api): add GET /api/0/devices endpoint (bucket identity phase 2.2)

aw_server/api.py

@@ -97,6 +97,10 @@ def get_info(self) -> Dict[str, Any]:
         }
         return payload
 
+    def get_devices(self) -> List[Dict[str, Any]]:
+        """Get list of known devices (currently only the local device)"""
+        return [{"id": get_device_id(), "hostname": gethostname()}]
+
     def get_buckets(self) -> Dict[str, Dict]:
         """Get dict {bucket_name: Bucket} of all buckets"""
         logger.debug("Received get request for buckets")

aw_server/rest.py

@@ -73,6 +73,14 @@ def decorator(*args, **kwargs):
     },
 )
 
+device = api.model(
+    "Device",
+    {
+        "id": fields.String(description="Stable device identifier (UUID)"),
+        "hostname": fields.String(description="Current hostname of the device"),
+    },
+)
+
 create_bucket = api.model(
     "CreateBucket",
     {
@@ -134,6 +142,14 @@ def get(self) -> Dict[str, Dict]:
         return current_app.api.get_info()
 
 
+@api.route("/0/devices")
+class DevicesResource(Resource):
+    @api.marshal_list_with(device)
+    @copy_doc(ServerAPI.get_devices)
+    def get(self):
+        return current_app.api.get_devices()
+
+
 # BUCKETS
 
 

tests/test_server.py

@@ -30,6 +30,23 @@ def test_info(flask_client):
     assert r.json["profile"] == "testing"
 
 
+def test_devices(flask_client):
+    r = flask_client.get("/api/0/devices")
+    assert r.status_code == 200
+    devices = r.json
+    assert isinstance(devices, list)
+    assert len(devices) == 1
+    device = devices[0]
+    assert "id" in device
+    assert "hostname" in device
+    # id is stable across calls
+    r2 = flask_client.get("/api/0/devices")
+    assert r2.json[0]["id"] == device["id"]
+    # id matches the server's own device_id
+    info = flask_client.get("/api/0/info").json
+    assert device["id"] == info["device_id"]
+
+
 def test_buckets(flask_client, bucket, benchmark):
     @benchmark
     def list_buckets():