📝 docs: gateway two-ids trap (network/ssids/scan-modbus-ip) #62
Loading…
Reference in a new issue
No description provided.
Delete branch "docs/gateway-ids-trap"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Live-verified 2026-09-06 against the probe account (
~/.secrets/comwatt, gatewayid=359/gatewayUid=BXCCBB77D9).Closes the third open item in
ROADMAP.md§1.What
The
/api/gateways/{id}/network,/ssidsand/scan-modbus-ipendpoints do not all take the same id — a third instance of the recurring "two ids" trap:/api/gateways/{id}(plain read)id400 Failed to convert 'id'/api/gateways/{id}/networkgatewayUidid→412 gateway.not.found.for.fetching.network.details(bare JSON array of Spring errors, not problem+json)/api/gateways/{id}/ssidsid400 "Failed to convert 'gatewayId' with value: '...'"(problem+json)/api/gateways/{id}/scan-modbus-ipgatewayUidid→403(empty body); thegatewayUidform actually triggers the long-running Modbus scanChanges
docs/energy.comwatt.com/devices.md— add a per-endpoint "two-ids trap" table + warning in the Gateways section.Docs-only; no client or test changes.
Live-verified 2026-09-06 against the probe account (gateway id=359, gatewayUid=BXCCBB77D9): - /api/gateways/{id}/network takes gatewayUid; numeric id -> 412 gateway.not.found.for.fetching.network.details (bare JSON array of Spring errors, not problem+json) - /api/gateways/{id}/ssids takes numeric id; gatewayUid -> 400 Failed to convert 'gatewayId' (problem+json) - /api/gateways/{id}/scan-modbus-ip takes gatewayUid; numeric id -> 403 (empty body); gatewayUid form triggers the long-running Modbus scan Add a per-endpoint table to devices.md and expand the README gotchas section into an explicit 'two ids' trap list (sites, capacities, gateways). Closes the third open item in ROADMAP.md §1.aaab40229c6d15c2b6a1e98fec17d8793cf7a9b7WIP: 📝 docs: gateway two-ids trap (network/ssids/scan-modbus-ip)to 📝 docs: gateway two-ids trap (network/ssids/scan-modbus-ip)