跳到主要内容

网络设置

Hostname 和 WiFi 凭据。


GET /api/setting/network

响应

{
"Hostname": "nm-cyd-c5-ab12cd",
"WiFiSSID": "MyHomeAP"
}
字段类型含义
Hostnamestring设备播报的 mDNS / NetBIOS hostname。
WiFiSSIDstring已配置的 WiFi SSID。

永远不会返回当前 WiFi 密码。


POST /api/setting/network

部分更新 — 只传你想改的字段。

请求

{
"Hostname": "garage-miner-01",
"WiFiSSID": "MyHomeAP",
"WiFiPWD": "supersecret"
}
字段类型必填含义
Hostnamestring新 hostname(建议只用字母数字 + -)。
WiFiSSIDstring新 SSID。
WiFiPWDstring新密码。只写不读。

响应

HTTP/1.1 200 OK
Content-Type: text/plain

OK

JSON 非法时返回 400。

示例

curl -X POST http://192.168.1.42/api/setting/network \
-H "Content-Type: application/json" \
-d '{"Hostname":"garage-miner-01"}'
注意

改 WiFi 凭据不会立即重新连网 — 下次开机才生效。