Red
Descripción general de endpoints
| Método | Ruta | Propósito |
|---|---|---|
| GET | /network/lan | Obtener la configuración de red por cable |
| PUT | /network/lan | Establecer la configuración de red por cable |
| GET | /network/wlan | Obtener la configuración IPv4 inalámbrica |
| PUT | /network/wlan | Establecer la configuración IPv4 inalámbrica |
| GET | /network/wifi | Obtener la información de la conexión Wi‑Fi actual |
| GET | /network/wifi-status | Consultar el estado de alimentación de Wi‑Fi |
| POST | /network/wifi-status?power=on/off | Conmutar la alimentación de Wi‑Fi |
| GET | /network/wifi-list | Escanear redes Wi‑Fi cercanas |
| POST | /network/wifi | Conectarse a Wi‑Fi |
| DELETE | /network/wifi | Desconectar o olvidar una red Wi‑Fi |
| GET | /web/setting | Consultar la configuración de la API HTTP |
| POST | /web/setting | Establecer la configuración de la API HTTP |
| GET | /ftp/setting | Consultar la configuración del servicio FTP |
| POST | /ftp/setting | Establecer la configuración del servicio FTP |
Configuración de LAN y WLAN
Obtener configuración
GET /network/lan
GET /network/wlan
Respuesta:
{
"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"
}
}
| Campo | Descripción |
|---|---|
dIpv4.sV4Address | Dirección IPv4 |
dIpv4.sV4Gateway | Puerta de enlace IPv4 |
dIpv4.sV4Method | Método de asignación de IP, dhcp o static |
dIpv4.sV4Netmask | Máscara de subred IPv4 |
dLink.sDNS1 / dLink.sDNS2 | Servidores DNS |
dLink.sAddress | Dirección MAC |
dLink.sInterface | Nombre de la interfaz de red, p. ej. eth0 o wlan0 |
dLink.iPower | Estado de alimentación de la interfaz |
dLink.bEnableMethod | Indica si la configuración manual está habilitada |
Establecer configuración
PUT /network/lan
PUT /network/wlan
Cuerpo de la solicitud:
{
"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
}
}
Respuesta:
{
"code": 0,
"message": "SUCCESS TO SET IP"
}
Información actual de Wi‑Fi
GET /network/wifi
La estructura de la respuesta es la misma que la de la configuración de LAN/WLAN.
Alimentación de Wi‑Fi
Consultar el estado de alimentación de Wi‑Fi
GET /network/wifi-status
Respuesta:
{
"iPower": 1,
"id": 1,
"sType": "wifi"
}
| Campo | Descripción |
|---|---|
iPower | Estado de alimentación de Wi‑Fi, 1 encendido, 0 apagado |
id | ID de la interfaz |
sType | Tipo de interfaz |
Conmutar la alimentación de Wi‑Fi
POST /network/wifi-status?power=on
POST /network/wifi-status?power=off
| Parámetro | Valor | Descripción |
|---|---|---|
power | on, off | Encender o apagar Wi‑Fi |
Escanear y conectar Wi‑Fi
Escanear lista de Wi‑Fi
GET /network/wifi-list
Respuesta:
[
{
"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
}
]
| Campo | Descripción |
|---|---|
sBssid | BSSID de Wi‑Fi, usado como identificador único para la conexión |
sSsid | Nombre de la red Wi‑Fi |
iFrequency | Canal de frecuencia |
iRssi | Intensidad de la señal |
sFlags | Tipo de seguridad |
sConnected | Indica si está conectado actualmente |
sReserved | Indica si la contraseña está guardada |
Conectarse a Wi‑Fi
POST /network/wifi
Cuerpo de la solicitud:
{
"sSsid": "58:b4:bb:93:b8:e3",
"sPassword": "your_wifi_password"
}
| Campo | Descripción |
|---|---|
sSsid | Identificador único de Wi‑Fi; usa el valor sBssid de /network/wifi-list |
sPassword | Contraseña de Wi‑Fi |
Respuesta:
{
"code": 0,
"message": ""
}
Desconectar u olvidar Wi‑Fi
DELETE /network/wifi?disconnect=<ssid>
DELETE /network/wifi?Ignore=<ssid>
| Parámetro | Descripción |
|---|---|
disconnect | Desconectarse de la red Wi‑Fi especificada |
Ignore | Olvidar la red Wi‑Fi especificada |
Respuesta:
{
"code": 0,
"message": "",
"status": 0
}
status | Descripción |
|---|---|
0 | Correcto |
-1 | Tiempo de espera agotado |
-2 | Contraseña incorrecta |
Configuración de la API HTTP
Consultar configuración
GET /web/setting
Respuesta:
{
"sEnable": true,
"sApiKey": "M8RZVF3hXrVDk*%2%LlN*^7nuCRHPiIT"
}
| Campo | Descripción |
|---|---|
sEnable | Indica si la API HTTP está habilitada |
sApiKey | Clave de API |
Establecer configuración
POST /web/setting
Cuerpo de la solicitud:
{
"sEnable": true,
"sApiKey": "your_api_key"
}
Configuración del servicio FTP
Consultar configuración
GET /ftp/setting
Respuesta:
{
"sEnable": false,
"sFtpPassword": "Seeed123.",
"sFtpPort": "21",
"sFtpUser": "ftpuser"
}
| Campo | Descripción |
|---|---|
sEnable | Indica si el servicio FTP está habilitado |
sFtpPort | Puerto FTP |
sFtpUser | Nombre de usuario FTP |
sFtpPassword | Contraseña FTP |
Establecer configuración
POST /ftp/setting
Cuerpo de la solicitud:
{
"sEnable": true,
"sFtpPort": "21",
"sFtpUser": "ftpuser",
"sFtpPassword": "StrongPassword123!"
}
Multidifusión
GET /network/muticast
nota
Este endpoint aparece en la tabla de API del dispositivo. Si el firmware actual no lo admite, el dispositivo puede devolver una respuesta 404 o API Not Found.
Códigos de error:
| Código | Descripción |
|---|---|
10001 | Contraseña FTP demasiado débil |
10004 | Puerto FTP fuera de rango |
10005 | Puerto FTP ya en uso |
Soporte técnico y debate sobre el producto
Gracias por elegir nuestros productos. Estamos aquí para ofrecerte diversos tipos de soporte y garantizar que tu experiencia con nuestros productos sea lo más fluida posible. Ofrecemos múltiples canales de comunicación para adaptarnos a diferentes preferencias y necesidades.