Skip to main content

网络

端点概览​

MethodPathPurpose
GET/network/lan获取有线网络配置
PUT/network/lan设置有线网络配置
GET/network/wlan获取无线 IPv4 配置
PUT/network/wlan设置无线 IPv4 配置
GET/network/wifi获取当前 Wi-Fi 连接信息
GET/network/wifi-status查询 Wi-Fi 电源状态
POST/network/wifi-status?power=on/off切换 Wi-Fi 电源
GET/network/wifi-list扫描附近的 Wi-Fi 网络
POST/network/wifi连接到 Wi-Fi
DELETE/network/wifi断开或忽略 Wi-Fi
GET/web/setting查询 HTTP API 设置
POST/web/setting设置 HTTP API
GET/ftp/setting查询 FTP 服务设置
POST/ftp/setting设置 FTP 服务

LAN 和 WLAN 配置​

获取配置​

GET /network/lan
GET /network/wlan

响应：

{
  "dIpv4": {
    "sV4Address": "192.168.7.200",
    "sV4Gateway": "192.168.6.2",
    "sV4Method": "static",
    "sV4Netmask": "255.255.254.0"
  },
  "dLink": {
    "bEnableMethod": true,
    "iPower": 1,
    "sAddress": "40:FD:F3:25:1A:8E",
    "sDNS1": "202.96.134.133",
    "sDNS2": "223.5.5.5",
    "sInterface": "wlan0"
  }
}
FieldDescription
dIpv4.sV4AddressIPv4 地址
dIpv4.sV4GatewayIPv4 网关
dIpv4.sV4MethodIP 分配方式，dhcp 或 static
dIpv4.sV4NetmaskIPv4 子网掩码
dLink.sDNS1 / dLink.sDNS2DNS 服务器
dLink.sAddressMAC 地址
dLink.sInterface网络接口名称，例如 eth0 或 wlan0
dLink.iPower接口电源状态
dLink.bEnableMethod是否启用手动配置

设置配置​

PUT /network/lan
PUT /network/wlan

请求体：

{
  "dIpv4": {
    "sV4Address": "192.168.1.123",
    "sV4Gateway": "192.168.1.1",
    "sV4Method": "dhcp",
    "sV4Netmask": "255.255.255.0"
  },
  "dLink": {
    "sDNS1": "8.8.8.8",
    "sDNS2": "8.8.4.4",
    "bEnableMethod": true
  }
}

响应：

{
  "code": 0,
  "message": "SUCCESS TO SET IP"
}

当前 Wi-Fi 信息​

GET /network/wifi

响应结构与 LAN/WLAN 配置相同。

Wi-Fi 电源​

查询 Wi-Fi 电源状态​

GET /network/wifi-status

响应：

{
  "iPower": 1,
  "id": 1,
  "sType": "wifi"
}
FieldDescription
iPowerWi-Fi 电源状态，1 开，0 关
id接口 ID
sType接口类型

切换 Wi-Fi 电源​

POST /network/wifi-status?power=on
POST /network/wifi-status?power=off
ParameterValueDescription
poweron, off打开或关闭 Wi-Fi

Wi-Fi 扫描与连接​

扫描 Wi-Fi 列表​

GET /network/wifi-list

响应：

[
  {
    "sBssid": "58:b4:bb:93:b8:e3",
    "sSsid": "SEEED-MKT",
    "iFrequency": 5180,
    "iRssi": -44,
    "sFlags": "[WPA-PSK-CCMP][WPA2-PSK-CCMP][ESS]",
    "sConnected": true,
    "sReserved": true
  }
]
FieldDescription
sBssidWi-Fi BSSID，用作连接的唯一标识符
sSsidWi-Fi 网络名称
iFrequency频段信道
iRssi信号强度
sFlags安全类型
sConnected是否当前已连接
sReserved是否已保存密码

连接到 Wi-Fi​

POST /network/wifi

请求体：

{
  "sSsid": "58:b4:bb:93:b8:e3",
  "sPassword": "your_wifi_password"
}
FieldDescription
sSsidWi-Fi 唯一标识符；使用 /network/wifi-list 中的 sBssid 值
sPasswordWi-Fi 密码

响应：

{
  "code": 0,
  "message": ""
}

断开或忽略 Wi-Fi​

DELETE /network/wifi?disconnect=<ssid>
DELETE /network/wifi?Ignore=<ssid>
ParameterDescription
disconnect从指定 Wi-Fi 断开连接
Ignore忘记指定 Wi-Fi

响应：

{
  "code": 0,
  "message": "",
  "status": 0
}
statusDescription
0成功
-1超时
-2密码错误

HTTP API 设置​

查询设置​

GET /web/setting

响应：

{
  "sEnable": true,
  "sApiKey": "M8RZVF3hXrVDk*%2%LlN*^7nuCRHPiIT"
}
FieldDescription
sEnable是否启用 HTTP API
sApiKeyAPI 密钥

设置​

POST /web/setting

请求体：

{
  "sEnable": true,
  "sApiKey": "your_api_key"
}

FTP 服务设置​

查询设置​

GET /ftp/setting

响应：

{
  "sEnable": false,
  "sFtpPassword": "Seeed123.",
  "sFtpPort": "21",
  "sFtpUser": "ftpuser"
}
FieldDescription
sEnable是否启用 FTP 服务
sFtpPortFTP 端口
sFtpUserFTP 用户名
sFtpPasswordFTP 密码

设置​

POST /ftp/setting

请求体：

{
  "sEnable": true,
  "sFtpPort": "21",
  "sFtpUser": "ftpuser",
  "sFtpPassword": "StrongPassword123!"
}

组播​

GET /network/muticast
note

此端点已在设备 API 表中列出。如果当前固件不支持，它可能会返回 404 或 API Not Found 响应。

错误码：

CodeDescription
10001FTP 密码强度太弱
10004FTP 端口超出范围
10005FTP 端口已被占用

技术支持与产品讨论​

感谢您选择我们的产品！我们将为您提供多种支持，确保您在使用产品的过程中体验顺畅。我们提供多种沟通渠道，以满足不同的偏好和需求。

Loading Comments...