功能描述
此 API 端点 POST /api/system/setNetworkServe
用于设置思源笔记是否在局域网中提供服务(是否可以通过局域网访问)。
它修改配置文件中的 conf.System.NetworkServe
项。设置成功后会向用户发送通知,并延迟3秒返回结果。
注意:更改此设置后可能需要重启应用才能完全生效。
请求参数
请求体必须是 JSON 格式,包含以下参数:
networkServe
(boolean): 必填。是否允许通过局域网访问思源笔记。true
: 启用网络伺服,允许局域网访问。false
: 禁用网络伺服,仅允许本机访问。
请求示例 (启用网络伺服):
{
"networkServe": true
}
请求示例 (禁用网络伺服):
{
"networkServe": false
}
响应结果
成功的请求将返回一个 JSON 对象,code
为 0,data
为 null
。同时会在界面上显示一条提示消息。
注意:此 API 会延迟 3 秒钟才返回响应,以便用户看到提示消息。
{
"code": 0,
"msg": "",
"data": null
}
如果操作失败(例如参数无效),将返回非 0 的 code
和具体的错误信息 msg
。
{
"code": -1, // 示例错误码
"msg": "Invalid parameter", // 示例错误信息
"data": null
}
在线测试
您可以在下方选择是否启用网络伺服进行在线测试。