文档首页
API docs by Redocly

爱快 OpenAPI - 无线 (1.0.0)

Download OpenAPI specification:

License: 内部测试文档

来源于 ikuai-doc/openapi_specs/wireless/。

为避免 Redoc 单页一次性加载全部 API 导致浏览器 heap 过高，部署版按分类拆分。

AC服务管理API

来源文件: wireless/ac_status.json

开启AC服务

启动AC控制器服务

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json
{
  • "message": "Success"
}

关闭AC服务

停止AC控制器服务

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json
{
  • "message": "Success"
}

获取AC服务状态

查询AC服务的当前运行状态

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json
{
  • "message": "Success",
  • "results": {
    }
}

获取所有AP配置列表

获取所有AP设备的配置信息和状态

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json
{
  • "message": "Success",
  • "results": {
    }
}

获取指定AP配置

根据ID获取指定AP设备的详细配置信息

Authorizations:
bearerAuth
path Parameters
id
required
integer >= 1

AP配置ID

Responses

Response samples

Content type
application/json
{
  • "message": "Success",
  • "results": {
    }
}

更新AP配置

更新指定AP设备的配置参数

注意： 本接口为全量修改，请求时需传入所有字段。无需修改的字段请保持原值或传空值，未传入的字段可能被重置。

Authorizations:
bearerAuth
path Parameters
id
required
integer >= 1

AP配置ID

Request Body schema: application/json
required

AP配置数据

id
required
integer

AP配置ID (主键)

gid
required
string

AP所属分组ID，0表示未加入分组

tagname
required
string

标识名称（支持中文/数字/字母/下划线/连字符，不能以符号开头，1-15字符）

comment
required
string

备注信息，最多64个字符，不支持特殊字符

mlo_radio0
required
integer

MLO radio0 2.4G频段开关

mlo_radio1
required
integer

MLO radio1 5G R1频段开关

mlo_radio2
required
integer

MLO radio2 5G R2频段开关

flicker
required
string
Enum: "off" "on"

定位闪烁灯

lights
required
integer

状态灯开关

ssid1
required
string

2.4G SSID1

ssid2
required
string

2.4G SSID2

hide_ssid1
required
integer

隐藏2.4G SSID1开关

hide_ssid2
required
integer

隐藏2.4G SSID2开关

isolate1
required
integer

2.4G SSID1的访客模式开关

isolate2
required
integer

2.4G SSID2的访客模式开关

qos_atf
required
integer

2.4G的ATF公平调度算法

load_strategy
required
integer

2.4G负载策略

autohide_maxsta
required
integer

2.4G负载策略阀值1

autohide_resume
required
integer

2.4G负载策略阀值2

max_pc
required
integer

2.4G最大带机量

channel
required
integer

2.4G信道

min_signal
required
integer

2.4G最低连接信号

enc1
required
string
Enum: "off" "wpa" "wpa2" "wpa+wpa2" "8021x"

2.4G SSID1加密策略

key1
required
string

2.4G SSID1密码

enc2
required
string
Enum: "off" "wpa" "wpa2" "wpa+wpa2" "8021x"

2.4G SSID2加密策略

key2
required
string

2.4G SSID2密码

ssid1_vlan
required
string
Enum: "off" "on"

2.4G SSID1 VLAN开关

ssid1_vlan_id
required
integer

2.4G SSID1 VLAN ID

ssid2_vlan
required
string
Enum: "off" "on"

2.4G SSID2 VLAN开关

ssid2_vlan_id
required
integer

2.4G SSID2 VLAN ID

ssid1_ratelimit
required
integer

2.4G SSID1限速开关

ssid1_upload
required
integer

2.4G SSID1上行限速

ssid1_download
required
integer

2.4G SSID1下行限速

ssid2_ratelimit
required
integer

2.4G SSID2限速开关

ssid2_upload
required
integer

2.4G SSID2上行限速

ssid2_download
required
integer

2.4G SSID2下行限速

auth_server1
required
string

2.4G SSID1 RADIUS服务器IP

auth_port1
required
integer

2.4G SSID1 RADIUS服务端口

acct_secret1
required
string

2.4G SSID1 RADIUS密钥

slave_auth1
required
integer

2.4G SSID1备份RADIUS服务是否开启

slave_auth_server1
required
string

2.4G SSID1备份RADIUS服务器IP

slave_auth_port1
required
integer

2.4G SSID1备份RADIUS服务端口

slave_acct_secret1
required
string

2.4G SSID1备份RADIUS密钥

auth_server2
required
string

2.4G SSID2 RADIUS服务器IP

auth_port2
required
integer

2.4G SSID2 RADIUS服务端口

acct_secret2
required
string

2.4G SSID2 RADIUS密钥

slave_auth2
required
integer

2.4G SSID2备份RADIUS服务是否开启

slave_auth_server2
required
string

2.4G SSID2备份RADIUS服务器IP

slave_auth_port2
required
integer

2.4G SSID2备份RADIUS服务端口

slave_acct_secret2
required
string

2.4G SSID2备份RADIUS密钥

signal_str
required
integer

2.4G信号强度

studio_ssid
required
string

2.4G工作室SSID

ssid3
required
string

5G SSID1

ssid4
required
string

5G SSID2

hide_ssid3
required
integer

5G隐藏SSID1开关

hide_ssid4
required
integer

5G隐藏SSID2开关

isolate3
required
integer

5G SSID1访客模式开关

isolate4
required
integer

5G SSID2访客模式开关

qos_atf_5g
required
integer

5G ATF公平调度算法

load_strategy_5g
required
integer

5G负载策略

autohide_maxsta_5g
required
integer

5G负载策略阀值1

autohide_resume_5g
required
integer

5G负载策略阀值2

max_pc_5g
required
integer

5G最大带机量

channel_5g
required
integer

5G信道

min_signal_5g
required
integer

5G最低连接信号

enc3
required
string
Enum: "off" "wpa" "wpa2" "wpa+wpa2" "8021x"

5G SSID1加密策略

key3
required
string

5G SSID1密码

enc4
required
string
Enum: "off" "wpa" "wpa2" "wpa+wpa2" "8021x"

5G SSID2加密策略

key4
required
string

5G SSID2密码

ssid3_vlan
required
string
Enum: "off" "on"

5G SSID1 VLAN开关

ssid3_vlan_id
required
integer

5G SSID1 VLAN ID

ssid4_vlan
required
string
Enum: "off" "on"

5G SSID2 VLAN开关

ssid4_vlan_id
required
integer

5G SSID2 VLAN ID

ssid3_ratelimit
required
integer

5G SSID1限速开关

ssid3_upload
required
integer

5G SSID1上行限速

ssid3_download
required
integer

5G SSID1下行限速

ssid4_ratelimit
required
integer

5G SSID2限速开关

ssid4_upload
required
integer

5G SSID2上行限速

ssid4_download
required
integer

5G SSID2下行限速

auth_server3
required
string

5G SSID1 RADIUS服务器IP

auth_port3
required
integer

5G SSID1 RADIUS服务端口

acct_secret3
required
string

5G SSID1 RADIUS密钥

slave_auth3
required
integer

5G SSID1备份RADIUS服务是否开启

slave_auth_server3
required
string

5G SSID1备份RADIUS服务器IP

slave_auth_port3
required
integer

5G SSID1备份RADIUS服务端口

slave_acct_secret3
required
string

5G SSID1备份RADIUS密钥

auth_server4
required
string

5G SSID2 RADIUS服务器IP

auth_port4
required
integer

5G SSID2 RADIUS服务端口

acct_secret4
required
string

5G SSID2 RADIUS密钥

slave_auth4
required
integer

5G SSID2备份RADIUS服务是否开启

slave_auth_server4
required
string

5G SSID2备份RADIUS服务器IP

slave_auth_port4
required
integer

5G SSID2备份RADIUS服务端口

slave_acct_secret4
required
string

5G SSID2备份RADIUS密钥

signal_str_5g
required
integer

5G信号强度

studio_ssid_5g
required
string

5G工作室SSID

task_switch1
required
integer

开启时间计划任务1

task_strategy1
required
string
Enum: "one" "month" "week"

任务策略1

task_date1
required
string

任务日期1

task_time1
required
string

任务时间1

task_switch2
required
integer

开启时间计划任务2

task_strategy2
required
string
Enum: "one" "month" "week"

任务策略2

task_date2
required
string

任务日期2

task_time2
required
string

任务时间2

task_switch3
required
integer

开启时间计划任务3

task_strategy3
required
string
Enum: "one" "month" "week"

任务策略3

task_date3
required
string

任务日期3

task_time3
required
string

任务时间3

reboot_strategy
required
string
Enum: "one" "month" "week"

重启策略

reboot_date
required
string

重启日期

channel_width_2g
required
integer
Enum: 20 40

2.4G频宽

channel_width_5g
required
integer
Enum: 20 40 80

5G频宽

port1_vlan
required
string
Enum: "off" "on"

端口1 VLAN开关

port1_vlan_id
required
integer

端口1 VLAN ID

port2_vlan
required
string
Enum: "off" "on"

端口2 VLAN开关

port2_vlan_id
required
integer

端口2 VLAN ID

port3_vlan
required
string
Enum: "off" "on"

端口3 VLAN开关

port3_vlan_id
required
integer

端口3 VLAN ID

port4_vlan
required
string
Enum: "off" "on"

端口4 VLAN开关

port4_vlan_id
required
integer

端口4 VLAN ID

ap_roaming
required
integer [ 0 .. 5 ]

AP快速漫游灵敏度设置

perfer_5g
required
integer

5G优先

studio_mode
required
integer

工作室模式开关

gateway_check
required
integer

网关检测开关

country
required
string
Enum: "CN" "US" "TW"

地区/国家码

ssid_union
required
integer

多频合一

ssid5
required
string

2.4G SSID3名称

ssid6
required
string

2.4G SSID4名称

hide_ssid5
required
integer

2.4G隐藏SSID3开关

hide_ssid6
required
integer

2.4G隐藏SSID4开关

isolate5
required
integer

2.4G SSID3访客模式开关

isolate6
required
integer

2.4G SSID4访客模式开关

enc5
required
string
Enum: "off" "wpa" "wpa2" "wpa+wpa2" "8021x"

2.4G SSID3加密策略

key5
required
string

2.4G SSID3密码

enc6
required
string
Enum: "off" "wpa" "wpa2" "wpa+wpa2" "8021x"

2.4G SSID4加密策略

key6
required
string

2.4G SSID4密码

ssid5_vlan
required
string
Enum: "off" "on"

2.4G SSID3 VLAN开关

ssid5_vlan_id
required
integer

2.4G SSID3 VLAN ID

ssid6_vlan
required
string
Enum: "off" "on"

2.4G SSID4 VLAN开关

ssid6_vlan_id
required
integer

2.4G SSID4 VLAN ID

ssid5_ratelimit
required
integer

2.4G SSID3限速开关

ssid5_upload
required
integer

2.4G SSID3上行限速

ssid5_download
required
integer

2.4G SSID3下行限速

ssid6_ratelimit
required
integer

2.4G SSID4限速开关

ssid6_upload
required
integer

2.4G SSID4上行限速

ssid6_download
required
integer

2.4G SSID4下行限速

auth_server5
required
string

2.4G SSID3 RADIUS服务器IP

auth_port5
required
integer

2.4G SSID3 RADIUS服务端口

acct_secret5
required
string

2.4G SSID3 RADIUS密钥

slave_auth5
required
integer

2.4G SSID3备份RADIUS服务是否开启

slave_auth_server5
required
string

2.4G SSID3备份RADIUS服务器IP

slave_auth_port5
required
integer

2.4G SSID3备份RADIUS服务端口

slave_acct_secret5
required
string

2.4G SSID3备份RADIUS密钥

auth_server6
required
string

2.4G SSID4 RADIUS服务器IP

auth_port6
required
integer

2.4G SSID4 RADIUS服务端口

acct_secret6
required
string

2.4G SSID4 RADIUS密钥

slave_auth6
required
integer

2.4G SSID4备份RADIUS服务是否开启

slave_auth_server6
required
string

2.4G SSID4备份RADIUS服务器IP

slave_auth_port6
required
integer

2.4G SSID4备份RADIUS服务端口

slave_acct_secret6
required
string

2.4G SSID4备份RADIUS密钥

ssid7
required
string

5G SSID3名称

ssid8
required
string

5G SSID4名称

hide_ssid7
required
integer

5G隐藏SSID3开关

hide_ssid8
required
integer

5G隐藏SSID4开关

isolate7
required
integer

5G SSID3访客模式开关

isolate8
required
integer

5G SSID4访客模式开关

enc7
required
string
Enum: "off" "wpa" "wpa2" "wpa+wpa2" "8021x"

5G SSID3加密策略

key7
required
string

5G SSID3密码

enc8
required
string
Enum: "off" "wpa" "wpa2" "wpa+wpa2" "8021x"

5G SSID4加密策略

key8
required
string

5G SSID4密码

ssid7_vlan
required
string
Enum: "off" "on"

5G SSID3 VLAN开关

ssid7_vlan_id
required
integer

5G SSID3 VLAN ID

ssid8_vlan
required
string
Enum: "off" "on"

5G SSID4 VLAN开关

ssid8_vlan_id
required
integer

5G SSID4 VLAN ID

ssid7_ratelimit
required
integer

5G SSID3限速开关

ssid7_upload
required
integer

5G SSID3上行限速

ssid7_download
required
integer

5G SSID3下行限速

ssid8_ratelimit
required
integer

5G SSID4限速开关

ssid8_upload
required
integer

5G SSID4上行限速

ssid8_download
required
integer

5G SSID4下行限速

auth_server7
required
string

5G SSID3 RADIUS服务器IP

auth_port7
required
integer

5G SSID3 RADIUS服务端口

acct_secret7
required
string

5G SSID3 RADIUS密钥

slave_auth7
required
integer

5G SSID3备份RADIUS服务是否开启

slave_auth_server7
required
string

5G SSID3备份RADIUS服务器IP

slave_auth_port7
required
integer

5G SSID3备份RADIUS服务端口

slave_acct_secret7
required
string

5G SSID3备份RADIUS密钥

auth_server8
required
string

5G SSID4 RADIUS服务器IP

auth_port8
required
integer

5G SSID4 RADIUS服务端口

acct_secret8
required
string

5G SSID4 RADIUS密钥

slave_auth8
required
integer

5G SSID4备份RADIUS服务是否开启

slave_auth_server8
required
string

5G SSID4备份RADIUS服务器IP

slave_auth_port8
required
integer

5G SSID4备份RADIUS服务端口

slave_acct_secret8
required
string

5G SSID4备份RADIUS密钥

ssid9
required
string

5G Radio2 SSID1名称

ssid10
required
string

5G Radio2 SSID2名称

ssid11
required
string

5G Radio2 SSID3名称

ssid12
required
string

5G Radio2 SSID4名称

hide_ssid9
required
integer

5G Radio2 SSID1隐藏开关

hide_ssid10
required
integer

5G Radio2 SSID2隐藏开关

hide_ssid11
required
integer

5G Radio2 SSID3隐藏开关

hide_ssid12
required
integer

5G Radio2 SSID4隐藏开关

isolate9
required
integer

5G Radio2 SSID1访客模式

isolate10
required
integer

5G Radio2 SSID2访客模式

isolate11
required
integer

5G Radio2 SSID3访客模式

isolate12
required
integer

5G Radio2 SSID4访客模式

enc9
required
string
Enum: "off" "wpa" "wpa2" "wpa+wpa2" "8021x"

5G Radio2 SSID1加密策略

key9
required
string

5G Radio2 SSID1密码

enc10
required
string
Enum: "off" "wpa" "wpa2" "wpa+wpa2" "8021x"

5G Radio2 SSID2加密策略

key10
required
string

5G Radio2 SSID2密码

enc11
required
string
Enum: "off" "wpa" "wpa2" "wpa+wpa2" "8021x"

5G Radio2 SSID3加密策略

key11
required
string

5G Radio2 SSID3密码

enc12
required
string
Enum: "off" "wpa" "wpa2" "wpa+wpa2" "8021x"

5G Radio2 SSID4加密策略

key12
required
string

5G Radio2 SSID4密码

ssid9_vlan
required
string
Enum: "off" "on"

5G Radio2 SSID1 VLAN开关

ssid9_vlan_id
required
integer

5G Radio2 SSID1 VLAN ID

ssid10_vlan
required
string
Enum: "off" "on"

5G Radio2 SSID2 VLAN开关

ssid10_vlan_id
required
integer

5G Radio2 SSID2 VLAN ID

ssid11_vlan
required
string
Enum: "off" "on"

5G Radio2 SSID3 VLAN开关

ssid11_vlan_id
required
integer

5G Radio2 SSID3 VLAN ID

ssid12_vlan
required
string
Enum: "off" "on"

5G Radio2 SSID4 VLAN开关

ssid12_vlan_id
required
integer

5G Radio2 SSID4 VLAN ID

ssid9_ratelimit
required
integer

5G Radio2 SSID1限速开关

ssid9_upload
required
integer

5G Radio2 SSID1上行限速

ssid9_download
required
integer

5G Radio2 SSID1下行限速

ssid10_ratelimit
required
integer

5G Radio2 SSID2限速开关

ssid10_upload
required
integer

5G Radio2 SSID2上行限速

ssid10_download
required
integer

5G Radio2 SSID2下行限速

ssid11_ratelimit
required
integer

5G Radio2 SSID3限速开关

ssid11_upload
required
integer

5G Radio2 SSID3上行限速

ssid11_download
required
integer

5G Radio2 SSID3下行限速

ssid12_ratelimit
required
integer

5G Radio2 SSID4限速开关

ssid12_upload
required
integer

5G Radio2 SSID4上行限速

ssid12_download
required
integer

5G Radio2 SSID4下行限速

auth_server9
required
string

5G Radio2 SSID1 RADIUS服务器IP

auth_port9
required
integer

5G Radio2 SSID1 RADIUS服务端口

acct_secret9
required
string

5G Radio2 SSID1 RADIUS密钥

slave_auth9
required
integer

5G Radio2 SSID1备份RADIUS服务是否开启

slave_auth_server9
required
string

5G Radio2 SSID1备份RADIUS服务器IP

slave_auth_port9
required
integer

5G Radio2 SSID1备份RADIUS服务端口

slave_acct_secret9
required
string

5G Radio2 SSID1备份RADIUS密钥

auth_server10
required
string

5G Radio2 SSID2 RADIUS服务器IP

auth_port10
required
integer

5G Radio2 SSID2 RADIUS服务端口

acct_secret10
required
string

5G Radio2 SSID2 RADIUS密钥

slave_auth10
required
integer

5G Radio2 SSID2备份RADIUS服务是否开启

slave_auth_server10
required
string

5G Radio2 SSID2备份RADIUS服务器IP

slave_auth_port10
required
integer

5G Radio2 SSID2备份RADIUS服务端口

slave_acct_secret10
required
string

5G Radio2 SSID2备份RADIUS密钥

auth_server11
required
string

5G Radio2 SSID3 RADIUS服务器IP

auth_port11
required
integer

5G Radio2 SSID3 RADIUS服务端口

acct_secret11
required
string

5G Radio2 SSID3 RADIUS密钥

slave_auth11
required
integer

5G Radio2 SSID3备份RADIUS服务是否开启

slave_auth_server11
required
string

5G Radio2 SSID3备份RADIUS服务器IP

slave_auth_port11
required
integer

5G Radio2 SSID3备份RADIUS服务端口

slave_acct_secret11
required
string

5G Radio2 SSID3备份RADIUS密钥

auth_server12
required
string

5G Radio2 SSID4 RADIUS服务器IP

auth_port12
required
integer

5G Radio2 SSID4 RADIUS服务端口

acct_secret12
required
string

5G Radio2 SSID4 RADIUS密钥

slave_auth12
required
integer

5G Radio2 SSID4备份RADIUS服务是否开启

slave_auth_server12
required
string

5G Radio2 SSID4备份RADIUS服务器IP

slave_auth_port12
required
integer

5G Radio2 SSID4备份RADIUS服务端口

slave_acct_secret12
required
string

5G Radio2 SSID4备份RADIUS密钥

load_strategy_d5g
required
integer

5G Radio2负载策略

autohide_maxsta_d5g
required
integer

5G Radio2负载策略阀值1

autohide_resume_d5g
required
integer

5G Radio2负载策略阀值2

qos_atf_d5g
required
integer

5G Radio2 ATF公平调度算法

channel_d5g
required
integer

5G Radio2信道

min_signal_d5g
required
integer

5G Radio2最低连接信号

signal_str_d5g
required
integer

5G Radio2信号强度

studio_ssid_d5g
required
string

5G Radio2工作室SSID列表

channel_width_d5g
required
integer
Enum: 20 40 80 160

5G Radio2频宽

advanced
required
integer

2.4G高级设置开关

beacon_interval
required
integer [ 100 .. 1000 ]

2.4G高级设置-beacon帧间隔

beacon_txpower
required
integer [ 0 .. 100 ]

2.4G高级设置-beacon发射功率

rts
required
integer [ 0 .. 2346 ]

2.4G高级设置-RTS门限

hwmode
required
string
Enum: "11b/g/n/ax/be" "11b/g/n/ax" "11b/g/n" "11n" "11b/g"

2.4G高级设置-射频工作模式

dis_legacy
required
string

2.4G高级设置-低速率接入限制

mgmt_rate
required
integer
Enum: 1000 2000 5500 6000 11000

2.4G高级设置-管理帧速率

advanced_5g
required
integer

5G Radio1高级设置开关

beacon_interval_5g
required
integer [ 100 .. 1000 ]

5G Radio1高级设置-beacon帧间隔

beacon_txpower_5g
required
integer [ 0 .. 100 ]

5G Radio1高级设置-beacon发射功率

rts_5g
required
integer [ 0 .. 2346 ]

5G Radio1高级设置-RTS门限

hwmode_5g
required
string
Enum: "11a/n/ac/ax/be" "11a/n/ac/ax" "11a/n/ac" "11n" "11a/n"

5G Radio1高级设置-射频工作模式

advanced_d5g
required
integer

5G Radio2高级设置开关

beacon_interval_d5g
required
integer [ 100 .. 1000 ]

5G Radio2高级设置-beacon帧间隔

beacon_txpower_d5g
required
integer [ 0 .. 100 ]

5G Radio2高级设置-beacon发射功率

rts_d5g
required
integer [ 0 .. 2346 ]

5G Radio2高级设置-RTS门限

hwmode_d5g
required
string
Enum: "11a/n/ac/ax/be" "11a/n/ac/ax" "11a/n/ac" "11n" "11a/n"

5G Radio2高级设置-射频工作模式

Responses

Request samples

Content type
application/json
{
  • "id": 1,
  • "gid": "0",
  • "tagname": "IK-H13_427hy999",
  • "comment": "",
  • "mlo_radio0": 0,
  • "mlo_radio1": 0,
  • "mlo_radio2": 0,
  • "flicker": "off",
  • "lights": 1,
  • "ssid1": "iKuai172_2G",
  • "ssid2": "",
  • "hide_ssid1": 0,
  • "hide_ssid2": 0,
  • "isolate1": 0,
  • "isolate2": 0,
  • "qos_atf": 0,
  • "load_strategy": 0,
  • "autohide_maxsta": 1,
  • "autohide_resume": 0,
  • "max_pc": 0,
  • "channel": 0,
  • "min_signal": 0,
  • "enc1": "off",
  • "key1": "12345678",
  • "enc2": "off",
  • "key2": "",
  • "ssid1_vlan": "off",
  • "ssid1_vlan_id": 1,
  • "ssid2_vlan": "off",
  • "ssid2_vlan_id": 1,
  • "ssid1_ratelimit": 0,
  • "ssid1_upload": 0,
  • "ssid1_download": 0,
  • "ssid2_ratelimit": 0,
  • "ssid2_upload": 0,
  • "ssid2_download": 0,
  • "auth_server1": "",
  • "auth_port1": 1812,
  • "acct_secret1": "",
  • "slave_auth1": 0,
  • "slave_auth_server1": "",
  • "slave_auth_port1": 1812,
  • "slave_acct_secret1": "",
  • "auth_server2": "",
  • "auth_port2": 1812,
  • "acct_secret2": "",
  • "slave_auth2": 0,
  • "slave_auth_server2": "",
  • "slave_auth_port2": 1812,
  • "slave_acct_secret2": "",
  • "signal_str": 0,
  • "studio_ssid": "",
  • "ssid3": "iKuai172_5G",
  • "ssid4": "",
  • "hide_ssid3": 0,
  • "hide_ssid4": 0,
  • "isolate3": 0,
  • "isolate4": 0,
  • "qos_atf_5g": 0,
  • "load_strategy_5g": 0,
  • "autohide_maxsta_5g": 1,
  • "autohide_resume_5g": 0,
  • "max_pc_5g": 0,
  • "channel_5g": 0,
  • "min_signal_5g": 0,
  • "enc3": "wpa2",
  • "key3": "12345678",
  • "enc4": "off",
  • "key4": "",
  • "ssid3_vlan": "off",
  • "ssid3_vlan_id": 1,
  • "ssid4_vlan": "off",
  • "ssid4_vlan_id": 1,
  • "ssid3_ratelimit": 0,
  • "ssid3_upload": 0,
  • "ssid3_download": 0,
  • "ssid4_ratelimit": 0,
  • "ssid4_upload": 0,
  • "ssid4_download": 0,
  • "auth_server3": "",
  • "auth_port3": 1812,
  • "acct_secret3": "",
  • "slave_auth3": 0,
  • "slave_auth_server3": "",
  • "slave_auth_port3": 1812,
  • "slave_acct_secret3": "",
  • "auth_server4": "",
  • "auth_port4": 1812,
  • "acct_secret4": "",
  • "slave_auth4": 0,
  • "slave_auth_server4": "",
  • "slave_auth_port4": 1812,
  • "slave_acct_secret4": "",
  • "signal_str_5g": 0,
  • "studio_ssid_5g": "",
  • "task_switch1": 0,
  • "task_strategy1": "one",
  • "task_date1": "2018-01-01",
  • "task_time1": "00:00-23:59",
  • "task_switch2": 0,
  • "task_strategy2": "one",
  • "task_date2": "2018-01-01",
  • "task_time2": "00:00-23:59",
  • "task_switch3": 0,
  • "task_strategy3": "one",
  • "task_date3": "2018-01-01",
  • "task_time3": "00:00-23:59",
  • "reboot_strategy": "one",
  • "reboot_date": "2018-01-01",
  • "channel_width_2g": 20,
  • "channel_width_5g": 40,
  • "port1_vlan": "off",
  • "port1_vlan_id": 1,
  • "port2_vlan": "off",
  • "port2_vlan_id": 1,
  • "port3_vlan": "off",
  • "port3_vlan_id": 1,
  • "port4_vlan": "off",
  • "port4_vlan_id": 1,
  • "ap_roaming": 1,
  • "perfer_5g": 1,
  • "studio_mode": 0,
  • "gateway_check": 0,
  • "country": "CN",
  • "ssid_union": 0,
  • "ssid5": "",
  • "ssid6": "",
  • "hide_ssid5": 0,
  • "hide_ssid6": 0,
  • "isolate5": 0,
  • "isolate6": 0,
  • "enc5": "off",
  • "key5": "",
  • "enc6": "off",
  • "key6": "",
  • "ssid5_vlan": "off",
  • "ssid5_vlan_id": 0,
  • "ssid6_vlan": "off",
  • "ssid6_vlan_id": 0,
  • "ssid5_ratelimit": 0,
  • "ssid5_upload": 0,
  • "ssid5_download": 0,
  • "ssid6_ratelimit": 0,
  • "ssid6_upload": 0,
  • "ssid6_download": 0,
  • "auth_server5": "",
  • "auth_port5": 1812,
  • "acct_secret5": "",
  • "slave_auth5": 0,
  • "slave_auth_server5": "",
  • "slave_auth_port5": 1812,
  • "slave_acct_secret5": "",
  • "auth_server6": "",
  • "auth_port6": 1812,
  • "acct_secret6": "",
  • "slave_auth6": 0,
  • "slave_auth_server6": "",
  • "slave_auth_port6": 1812,
  • "slave_acct_secret6": "",
  • "ssid7": "",
  • "ssid8": "",
  • "hide_ssid7": 0,
  • "hide_ssid8": 0,
  • "isolate7": 0,
  • "isolate8": 0,
  • "enc7": "off",
  • "key7": "",
  • "enc8": "off",
  • "key8": "",
  • "ssid7_vlan": "off",
  • "ssid7_vlan_id": 0,
  • "ssid8_vlan": "off",
  • "ssid8_vlan_id": 0,
  • "ssid7_ratelimit": 0,
  • "ssid7_upload": 0,
  • "ssid7_download": 0,
  • "ssid8_ratelimit": 0,
  • "ssid8_upload": 0,
  • "ssid8_download": 0,
  • "auth_server7": "",
  • "auth_port7": 1812,
  • "acct_secret7": "",
  • "slave_auth7": 0,
  • "slave_auth_server7": "",
  • "slave_auth_port7": 1812,
  • "slave_acct_secret7": "",
  • "auth_server8": "",
  • "auth_port8": 1812,
  • "acct_secret8": "",
  • "slave_auth8": 0,
  • "slave_auth_server8": "",
  • "slave_auth_port8": 1812,
  • "slave_acct_secret8": "",
  • "ssid9": "",
  • "ssid10": "",
  • "ssid11": "",
  • "ssid12": "",
  • "hide_ssid9": 0,
  • "hide_ssid10": 0,
  • "hide_ssid11": 0,
  • "hide_ssid12": 0,
  • "isolate9": 0,
  • "isolate10": 0,
  • "isolate11": 0,
  • "isolate12": 0,
  • "enc9": "off",
  • "key9": "",
  • "enc10": "off",
  • "key10": "",
  • "enc11": "off",
  • "key11": "",
  • "enc12": "off",
  • "key12": "",
  • "ssid9_vlan": "off",
  • "ssid9_vlan_id": 1,
  • "ssid10_vlan": "off",
  • "ssid10_vlan_id": 1,
  • "ssid11_vlan": "off",
  • "ssid11_vlan_id": 1,
  • "ssid12_vlan": "off",
  • "ssid12_vlan_id": 1,
  • "ssid9_ratelimit": 0,
  • "ssid9_upload": 0,
  • "ssid9_download": 0,
  • "ssid10_ratelimit": 0,
  • "ssid10_upload": 0,
  • "ssid10_download": 0,
  • "ssid11_ratelimit": 0,
  • "ssid11_upload": 0,
  • "ssid11_download": 0,
  • "ssid12_ratelimit": 0,
  • "ssid12_upload": 0,
  • "ssid12_download": 0,
  • "auth_server9": "",
  • "auth_port9": 1812,
  • "acct_secret9": "",
  • "slave_auth9": 0,
  • "slave_auth_server9": "",
  • "slave_auth_port9": 1812,
  • "slave_acct_secret9": "",
  • "auth_server10": "",
  • "auth_port10": 1812,
  • "acct_secret10": "",
  • "slave_auth10": 0,
  • "slave_auth_server10": "",
  • "slave_auth_port10": 1812,
  • "slave_acct_secret10": "",
  • "auth_server11": "",
  • "auth_port11": 1812,
  • "acct_secret11": "",
  • "slave_auth11": 0,
  • "slave_auth_server11": "",
  • "slave_auth_port11": 1812,
  • "slave_acct_secret11": "",
  • "auth_server12": "",
  • "auth_port12": 1812,
  • "acct_secret12": "",
  • "slave_auth12": 0,
  • "slave_auth_server12": "",
  • "slave_auth_port12": 1812,
  • "slave_acct_secret12": "",
  • "load_strategy_d5g": 0,
  • "autohide_maxsta_d5g": 1,
  • "autohide_resume_d5g": 0,
  • "qos_atf_d5g": 0,
  • "channel_d5g": 0,
  • "min_signal_d5g": 0,
  • "signal_str_d5g": 0,
  • "studio_ssid_d5g": "",
  • "channel_width_d5g": 40,
  • "advanced": 0,
  • "beacon_interval": 200,
  • "beacon_txpower": 0,
  • "rts": 0,
  • "hwmode": "",
  • "dis_legacy": "0",
  • "mgmt_rate": 1000,
  • "advanced_5g": 0,
  • "beacon_interval_5g": 200,
  • "beacon_txpower_5g": 0,
  • "rts_5g": 0,
  • "hwmode_5g": "",
  • "advanced_d5g": 0,
  • "beacon_interval_d5g": 200,
  • "beacon_txpower_d5g": 0,
  • "rts_d5g": 0,
  • "hwmode_d5g": ""
}

Response samples

Content type
application/json
Example
{
  • "code": 0,
  • "message": "Success"
}

无线访问控制管理API

来源文件: wireless/wireless-wls-black.json

获取无线黑白名单列表

获取当前配置的无线黑白名单规则列表，支持分页功能。 包含规则状态、模式、MAC地址列表、SSID、AP、时间控制等信息。

Authorizations:
bearerAuth
query Parameters
page
integer >= 1
Default: 1
Example: page=1

页码（从1开始）

limit
integer >= 1
Default: 20
Example: limit=20

每页记录数

order
string
Default: "asc"
Enum: "asc" "desc"
Example: order=asc

排序方向，asc为升序（默认），desc为降序

order_by
string
Default: "id"
Example: order_by=id

排序字段，支持id、tagname、enabled等字段

Responses

Response samples

Content type
application/json
{
  • "message": "Success",
  • "results": {
    }
}

添加无线黑白名单配置

添加新的无线黑白名单规则，支持黑名单和白名单两种模式。 可以设置MAC地址过滤、SSID和AP设备控制、时间段限制等。

Authorizations:
bearerAuth
Request Body schema: application/json
required

无线黑白名单配置数据

enabled
required
string
Enum: "yes" "no"

状态，yes为启用，no为停用

tagname
required
string <= 15 characters ^[a-zA-Z0-9_-]+$

名称，支持中文、英文、数字、下划线和连字符，1-15个字符，不能以下划线或连字符开头

mode
required
integer
Default: 0
Enum: 0 1

模式，0为黑名单，1为白名单

required
object (wireless_wireless_wls_black_MacList)
lssid
required
string^[a-zA-Z0-9-_,]+$
Default: "ALL"

SSID列表，ALL表示所有SSID

lap
string^[a-zA-Z0-9-_,]+$
Default: "ALL"

AP列表，ALL表示所有AP，支持MAC地址格式

week
required
string^[1-7]*$
Default: "1234567"

生效周期，1234567表示周一到周日

time
required
string^([0-9]{2}:[0-9]{2}-[0-9]{2}:[0-9]{2})(,([0-9...
Default: "00:00-23:59"

生效时间段，支持多个时间段用逗号分隔

comment
string <= 64 characters

备注信息，最多64个字符，不支持特殊字符

Responses

Request samples

Content type
application/json
{
  • "enabled": "yes",
  • "tagname": "11",
  • "mode": 0,
  • "lmac": {
    },
  • "lssid": "10095g",
  • "lap": "08:9b:4b:01:00:01",
  • "week": "1234567",
  • "time": "00:00-23:59",
  • "comment": ""
}

Response samples

Content type
application/json
Example
{
  • "code": 0,
  • "message": "success",
  • "rowid": 1
}

获取指定无线黑白名单

根据规则ID获取单个无线黑白名单规则的详细信息。

Authorizations:
bearerAuth
path Parameters
id
required
integer <int64> >= 1
Example: 1

无线访问控制规则ID

Responses

Response samples

Content type
application/json
{
  • "message": "Success",
  • "results": {
    }
}

更新无线黑白名单的配置

完全更新现有的无线黑白名单规则配置。 需要提供所有字段。

Authorizations:
bearerAuth
path Parameters
id
required
integer <int64> >= 1
Example: 1

无线访问控制规则ID

Request Body schema: application/json
required

完整的无线黑白名单配置数据

enabled
required
string
Enum: "yes" "no"

状态，yes为启用，no为停用

tagname
required
string <= 15 characters ^[a-zA-Z0-9_-]+$

名称，支持中文、英文、数字、下划线和连字符，1-15个字符，不能以下划线或连字符开头

mode
required
integer
Default: 0
Enum: 0 1

模式，0为黑名单，1为白名单

required
object (wireless_wireless_wls_black_MacList)
lssid
required
string^[a-zA-Z0-9-_,]+$
Default: "ALL"

SSID列表，ALL表示所有SSID

lap
string^[a-zA-Z0-9-_,]+$
Default: "ALL"

AP列表，ALL表示所有AP，支持MAC地址格式

week
required
string^[1-7]*$
Default: "1234567"

生效周期，1234567表示周一到周日

time
required
string^([0-9]{2}:[0-9]{2}-[0-9]{2}:[0-9]{2})(,([0-9...
Default: "00:00-23:59"

生效时间段，支持多个时间段用逗号分隔

comment
string <= 64 characters

备注信息，最多64个字符，不支持特殊字符

Responses

Request samples

Content type
application/json
{
  • "enabled": "yes",
  • "tagname": "11",
  • "mode": 0,
  • "lmac": {
    },
  • "lssid": "10095g",
  • "lap": "08:9b:4b:01:00:01",
  • "week": "1234567",
  • "time": "00:00-23:59",
  • "comment": ""
}

Response samples

Content type
application/json
Example
{
  • "code": 0,
  • "message": "Success"
}

启用/停用无线黑白名单

部分更新无线黑白名单规则配置，主要用于启用/停用规则状态。 支持修改enabled字段来控制规则的执行状态。

Authorizations:
bearerAuth
path Parameters
id
required
integer <int64> >= 1
Example: 1

无线访问控制规则ID

Request Body schema: application/json
required

部分更新数据（如启用状态）

enabled
required
string
Enum: "yes" "no"

规则启用状态

Responses

Request samples

Content type
application/json
{
  • "enabled": "yes"
}

Response samples

Content type
application/json
Example
{
  • "code": 0,
  • "message": "Success"
}

删除无线黑白名单

删除指定的无线黑白名单规则。 删除后无法恢复，请谨慎操作。

Authorizations:
bearerAuth
path Parameters
id
required
integer <int64> >= 1
Example: 1

无线访问控制规则ID

Responses

Response samples

Content type
application/json
{
  • "message": "Success"
}

无线终端VLAN管理API

来源文件: wireless/wireless-wls-mvlan.json

获取无线终端VLAN列表

获取当前配置的无线终端VLAN规则列表，支持分页功能。 包含规则状态、VLAN ID、MAC地址列表、SSID配置等信息。

Authorizations:
bearerAuth
query Parameters
page
integer >= 1
Default: 1
Example: page=1

页码（从1开始）

limit
integer >= 1
Default: 20
Example: limit=20

每页记录数

order
string
Default: "asc"
Enum: "asc" "desc"
Example: order=asc

排序方向，asc为升序（默认），desc为降序

order_by
string
Default: "id"
Example: order_by=id

排序字段，支持id、tagname、enabled、vlanid等字段

Responses

Response samples

Content type
application/json
{
  • "message": "Success",
  • "results": {
    }
}

添加无线终端VLAN配置

添加新的无线终端VLAN分配规则，为特定MAC地址或MAC组 分配指定的VLAN ID。支持SSID过滤控制。

Authorizations:
bearerAuth
Request Body schema: application/json
required

无线终端VLAN配置数据

enabled
required
string
Enum: "yes" "no"

状态，yes为启用，no为停用

tagname
required
string <= 15 characters ^[a-zA-Z0-9_-]+$

名称，支持中文、英文、数字、下划线和连字符，1-15个字符，不能以下划线或连字符开头

vlanid
required
integer [ 1 .. 4090 ]
Default: 0

VLAN ID

required
object (wireless_wireless_wls_mvlan_MacList)
lssid
required
string^[a-zA-Z0-9-_,]+$
Default: "ALL"

SSID列表，不传或传空时默认匹配全部 SSID（ALL）

comment
string <= 64 characters

备注信息，最多64个字符，不支持特殊字符

Responses

Request samples

Content type
application/json
{
  • "enabled": "yes",
  • "tagname": "22",
  • "vlanid": 11,
  • "lmac": {
    },
  • "lssid": "10095g",
  • "comment": ""
}

Response samples

Content type
application/json
Example
{
  • "code": 0,
  • "message": "success",
  • "rowid": 1
}

获取指定无线终端VLAN

根据规则ID获取单个无线终端VLAN分配规则的详细信息。

Authorizations:
bearerAuth
path Parameters
id
required
integer <int64> >= 1
Example: 1

无线终端VLAN规则ID

Responses

Response samples

Content type
application/json
{
  • "message": "Success",
  • "results": {
    }
}

更新无线终端VLAN的配置

完全更新现有的无线终端VLAN分配规则配置。 需要提供所有字段。

Authorizations:
bearerAuth
path Parameters
id
required
integer <int64> >= 1
Example: 1

无线终端VLAN规则ID

Request Body schema: application/json
required

完整的无线终端VLAN配置数据

enabled
required
string
Enum: "yes" "no"

状态，yes为启用，no为停用

tagname
required
string <= 15 characters ^[a-zA-Z0-9_-]+$

名称，支持中文、英文、数字、下划线和连字符，1-15个字符，不能以下划线或连字符开头

vlanid
required
integer [ 1 .. 4090 ]
Default: 0

VLAN ID

required
object (wireless_wireless_wls_mvlan_MacList)
lssid
required
string^[a-zA-Z0-9-_,]+$
Default: "ALL"

SSID列表，不传或传空时默认匹配全部 SSID（ALL）

comment
string <= 64 characters

备注信息，最多64个字符，不支持特殊字符

Responses

Request samples

Content type
application/json
{
  • "enabled": "yes",
  • "tagname": "22",
  • "vlanid": 11,
  • "lmac": {
    },
  • "lssid": "10095g",
  • "comment": ""
}

Response samples

Content type
application/json
Example
{
  • "code": 0,
  • "message": "Success"
}

启用/停用无线终端VLAN

部分更新无线终端VLAN分配规则配置，主要用于启用/停用规则状态。 支持修改enabled字段来控制规则的执行状态。

Authorizations:
bearerAuth
path Parameters
id
required
integer <int64> >= 1
Example: 1

无线终端VLAN规则ID

Request Body schema: application/json
required

部分更新数据（如启用状态）

enabled
required
string
Enum: "yes" "no"

规则启用状态

Responses

Request samples

Content type
application/json
{
  • "enabled": "yes"
}

Response samples

Content type
application/json
Example
{
  • "code": 0,
  • "message": "Success"
}

删除无线终端VLAN

删除指定的无线终端VLAN分配规则。 删除后无法恢复，请谨慎操作。

Authorizations:
bearerAuth
path Parameters
id
required
integer <int64> >= 1
Example: 1

无线终端VLAN规则ID

Responses

Response samples

Content type
application/json
{
  • "message": "Success"
}