跳到主要内容

网络设置

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 凭据不会立即重新连网 — 下次开机才生效。