Integration
REST API v1
Platform agent telemetry and tenant workload APIs. Site hosts do not use this API. Write routes require header X-API-Key. Base: https://homecloud.wead.live
Who Uses This API
Data Center Operators
Layer 4 — fund solar + boxes at host sites, operate agents remotely, dispatch workloads, pay host income. Use node register/heartbeat endpoints.
Workload Tenants
Third-party customers submitting storage, inference, cache, or gaming jobs. Use workload create/assign endpoints; WeAD routes to the best node.
Site Hosts
No API access. Hosts provide roof/ground space and indoor footprint only. Earnings are paid by data centers — not via this control plane.
Node Endpoints (data center agent · platform)
Called by agents in data-center-funded, locked Data House units — provisioned at install. Never exposed to site hosts.
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/v1/nodes/register | Register new edge node |
| POST | /api/v1/nodes/{id}/heartbeat | Ingest telemetry → score + class |
| GET | /api/v1/nodes | List fleet with latest metrics |
| GET | /api/v1/nodes/{id} | Node detail + 50-point history |
Workload Endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/v1/workloads | Queue workload job |
| POST | /api/v1/workloads/{id}/assign | Auto-route to optimal node |
| GET | /api/v1/workloads | List recent workloads |
Example — Submit & Assign
$ curl -X POST https://homecloud.wead.live/api/v1/workloads \ -H "Content-Type: application/json" \ -d '{"kind":"inference","bandwidth_class":"B","payload":{"model":"llama-3-8b"}}' $ curl -X POST https://homecloud.wead.live/api/v1/workloads/wl_abc123/assign → { "workload_id": "wl_abc123", "assigned_node_id": "node_…", "status": "assigned" }
Health Check
GET /health → { "ok": true, "service": "homecloud-control", "version": "0.1.0" }
Machine-readable schema: /docs (OpenAPI 3.0)