Skip to content

Overview

Rate Limit

For the Wifi REST API the following will be true:

  • Limits are applied to each tenant.
  • A maximum of 200 calls can be made per second.
  • Each second 100 calls will be returned to be used.
Download OpenAPI description
Languages
Servers
Asian region

https://api.asia.ruckus.cloud/

European region

https://api.eu.ruckus.cloud/

North American region

https://api.ruckus.cloud/

Wi-Fi Calling Service Profile

Manage Wi-Fi calling service profiles.

Operations

Wi-Fi Network Activation

Manage Wi-Fi network-venue activation relationships.

Operations

AP

Manage APs including pinging, trace-routing, resetting, rebooting, floor-plan positioning and LAN-Ports settings.

Operations

Get APDeprecated

Request

Get the AP operational and configuration data.

Path
serialNumberstringrequired

The serial number of the AP.

Query
operationalboolean

Include operational data in response

Default false
No request payload

Responses

OK

Bodyapplication/json
apGroupIdstring
bssColoringobject(ApBssColoring)

BSS Coloring Setting of an AP.

clientAdmissionControlobject(ApClientAdmissionControl)

AP Client Admission Control Settings

clientCountinteger(int32)read-only
descriptionstring[ 0 .. 180 ] characters
deviceGpsobject(DeviceGps)

Ap or Venue latitude and longitude

externalIpstringread-only
Default "null"
firmwarestringread-only
Default "null"
indoorModelbooleanread-only
Default false
ipstringread-only
Default "null"
lanPortsobject(ApLanPorts)

AP model specific configuration for AP LAN ports and external antenna.

lastContactedstringread-only
Default "null"
lastUpdatedstringread-only
Default "null"
macstringread-only
Default "null"
meshRolestringread-only
Default "null"
modelstring[ 0 .. 64 ] characters
Default "null"
namestring(?=^((?!`|\$\()[ -_a-~]){2,32}$)^(\S.*\S)$required
poePortStatusstringread-only
Default "null"
positionobject(ApPosition)

AP position object

radioobject(ApRadioCustomization)

AP radio customization

serialNumberstring^[1-9][0-9]{11}$required
softDeletedboolean
Default false
softDeletedDatestring(date-time)
statestringread-only
Default "null"
Enum"InSetupPhase""Operational""RequiresAttention""TransientIssue"
subStatestringread-only
Default "null"
Enum"NeverContactedCloud""Initializing""Operational""ApplyingFirmware""ApplyingConfiguration""FirmwareUpdateFailed""ConfigurationUpdateFailed""DisconnectedFromCloud""Rebooting"
tagsArray of strings[ 0 .. 24 ] items
uptime_secondsinteger(int64)read-only
venueIdstringrequired
Response
application/json
{ "apGroupId": "string", "bssColoring": { "bssColoringEnabled": false, "useVenueSettings": true }, "clientAdmissionControl": { "enable24G": false, "enable50G": false, "maxRadioLoad24G": 75, "maxRadioLoad50G": 75, "minClientCount24G": 10, "minClientCount50G": 20, "minClientThroughput24G": 0, "minClientThroughput50G": 0, "useVenueSettings": true }, "clientCount": 0, "description": "string", "deviceGps": { "latitude": "string", "longitude": "string" }, "externalIp": "null", "firmware": "null", "indoorModel": false, "ip": "null", "lanPorts": { "lanPorts": [ … ], "poeOut": false, "useVenueSettings": false }, "lastContacted": "null", "lastUpdated": "null", "mac": "null", "meshRole": "null", "model": "null", "name": "string", "poePortStatus": "null", "position": { "floorplanId": "string", "xPercent": 0, "yPercent": 0 }, "radio": { "apRadioParams24G": { … }, "apRadioParams50G": { … }, "apRadioParams6G": { … }, "apRadioParamsDual5G": { … }, "enable24G": false, "enable50G": false, "enable6G": false, "useVenueSettings": true }, "serialNumber": "string", "softDeleted": false, "softDeletedDate": "2019-08-24T14:15:22Z", "state": "InSetupPhase", "subState": "NeverContactedCloud", "tags": [ "string" ], "uptime_seconds": 0, "venueId": "string" }

Trigger AP ActionDeprecated

Request

Trigger AP action.

Path
serialNumberstringrequired

The serial number of the AP.

Bodyapplication/jsonrequired
actionstringrequired
Enum"ping""traceRoute""reboot""factoryReset""blinkLed"
targetHoststring(^((22[0-3]|2[0-1][0-9]|1[0-9][0-9]|[1-9][0-9...
application/json
{ "action": "ping", "targetHost": "string" }

Responses

OK

Bodyapplication/json
requestIdstring
responseobject(ApPatchResponse)

Trigger AP action response

Response
application/json
{ "requestId": "string", "response": { "response": "string" } }

Update APDeprecated

Request

Update an AP.

Path
serialNumberstringrequired

The serial number of the AP.

Bodyapplication/jsonrequired
apGroupIdstring
descriptionstring[ 0 .. 180 ] characters
deviceGpsobject(DeviceGps)

Ap or Venue latitude and longitude

modelstring[ 0 .. 64 ] characters
Default "null"
namestring(?=^((?!`|\$\()[ -_a-~]){2,32}$)^(\S.*\S)$required
positionobject(ApPosition)

AP position object

serialNumberstring^[1-9][0-9]{11}$required
tagsArray of strings[ 0 .. 24 ] items
venueIdstringrequired
application/json
{ "apGroupId": "string", "description": "string", "deviceGps": { "latitude": "string", "longitude": "string" }, "model": "null", "name": "string", "position": { "floorplanId": "string", "xPercent": 0, "yPercent": 0 }, "serialNumber": "string", "tags": [ "string" ], "venueId": "string" }

Responses

Accepted

Bodyapplication/json
requestIdstring
Response
application/json
{ "requestId": "string" }

L3ACL Policy

Manage layer-3 ACL policy profiles.

Operations

RADIUS Profile

Manage RADIUS server profiles.

Operations

Syslog Server Profile

Manage Syslog server profiles.

Operations

Wi-Fi Network

Managing the relationships for Wi-Fi network activation within venue associations.

Operations

Application Policy

Manage application policy profiles.

Operations

AP Group

Manage AP-Groups.

Operations

Client

Manage client connections.

Operations

DHCP Configuration Service Profile

Manage DHCP configuration service profiles.

Operations

Client Isolation Allowlist

Manage client isolation allowlists.

Client isolation features, when enabled, prevent clients residing on a common VLAN from exchanging packets with each other. Client isolation is enforced by APs working at layer 2 (bridging). If client isolation is needed between VLANs/IP subnets, routers must also be configured to prevent packet exchange at layer 3. A client isolation allowlist provides the capability for administrators to configure exceptions to this isolation behavior. For example, an administrator may want to allow clients on a public network to access a printer in a common area of their venue. If so, the MAC and IP addresses of the printer (or any excepted device) can be configured on the client isolation allowlist.

Client isolation can be used in conjunction with walled gardens for public networks. Walled gardens provide limited access to services prior to client authentication whereas client isolation allowlists provide connectivity options post authentication.

Client isolation does not work when clients are assigned static IP addresses. For this reason, Ruckus recommends using DHCP lease reservations in lieu of static IP addresses when using this feature. Administrators may also want to consider use of the force DHCP option, available during wireless network configuration.

Complications to client isolation can arise when the VLAN's default gateway employs VRRP or HSRP for high availability or when Multicast DNS Proxy is configured on the same WLAN as the allowlist. If either of these situations applies in your network, please contact Ruckus customer support for assistance.

Operations

AP SNMP Agent Profile

Manage AP SNMP policy profiles.

Operations

Rogue AP Detection Policy

Manage rogue AP detection policies.

Rogue APs are Wi-Fi APs which are in radio range of your Wi-Fi network, but are unknown to the Ruckus cloud. For example, these may be APs in installed your venues without explicit authorization from your administrators, whether added by a well-meaning employee or by a malicious attacker; as such, they could be on the same LAN as your authorized APs. They could also be APs installed in nearby venues (for example, if your venue is part of a multi-tenant facility). Rogue classification polices help to automatically classify these unknown APs by setting up rules which trigger a rogue AP report when specific-rogue detection criteria are met.

Operations

AP Venue

Manage Wi-Fi venue configuration, including radio settings, mesh, LEDs, LAN-ports, and syslog.

Operations

L2ACL Policy

Manage layer-2 ACL policy profiles.

Operations

Device Policy

Manage device policies.

Operations

MDNS Proxy Service Profile

Manage Multicast DNS proxy service profiles.

Operations

Access Control Profile

Manage access control profiles.

Operations

VLAN Pool

Manage VLAN pool profiles.

Operations

Recovery

Retrieve and set the recovery PSK.

Operations