API docs by Redocly

Zyxel Nebula OpenAPI (0.1.26)

Download OpenAPI specification:Download

Zyxel Nebula OpenAPI

groups

Group operations

Get Groups

header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Organizations From A Group

path Parameters
groupId
required
string (Groupid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

organizations

Organization operations

Get Orgnazations

Get the organizations

  • name: Org's name
  • orgId: Org's unique ID
  • mode: Org's license mode
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Org Info

path Parameters
orgId
required
string (The ID of the org) >= 16 characters
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
Example
{
  • "name": "string",
  • "orgId": "string",
  • "mode": "PRO",
  • "prevMode": "PRO",
  • "licenseOverview": {
    }
}

Get Sites

path Parameters
orgId
required
string (The ID of the org) >= 16 characters
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Devices From An Org

path Parameters
orgId
required
string (The ID of the org) >= 16 characters
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Device Firmware Status From An Org

path Parameters
orgId
required
string (The ID of the org) >= 16 characters
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

sites

Site operations

Get Device Firmware Status From A Site

path Parameters
siteId
required
string (Siteid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Devices Online By Type

path Parameters
siteId
required
string (Siteid)
query Parameters
type
string (Type)
Enum: "AP" "SW" "GW" "FIREWALL" "WWAN" "SCR" "GWH" "ACCY"
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Site Vpn Status

path Parameters
siteId
required
string (Siteid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
{
  • "sites": [
    ],
  • "gateways": [
    ],
  • "remoteAps": [
    ],
  • "cleints": [
    ]
}

Get Site Clients

This API returns the last 2 hours data of site-wide clients.

path Parameters
siteId
required
string (Siteid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
Array
string (ClientAttributesReq)
Enum: "mac_address" "ipv4" "vlan" "last_seen" "connected_device_id" "status" "first_seen" "description" "os_hostname" "manufacturer"

Responses

Request samples

Content type
application/json
[
  • "mac_address"
]

Response samples

Content type
application/json
[
  • {
    }
]

Get Ap Clients

This API returns the last 2 hours data of AP clients.

path Parameters
siteId
required
string (Siteid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
Array
string (APClientAttributesReq)
Enum: "mac_address" "ipv4" "last_seen" "connected_device_id" "first_seen" "description" "os_hostname" "manufacturer" "ssid" "wifi_sta"

Responses

Request samples

Content type
application/json
[
  • "mac_address"
]

Response samples

Content type
application/json
[
  • {
    }
]

Ping

Instruct the device to ping the target address. The token must be null to initialize the ping task, and then use the returned token to fetch the results.

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
target
required
string (Target)
Token (string) or Token (null) (Token)

Responses

Request samples

Content type
application/json
{
  • "target": "string",
  • "token": "string"
}

Response samples

Content type
application/json
{
  • "token": "string",
  • "isDone": true,
  • "results": [
    ]
}

Reboot

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
{
  • "status": 0,
  • "message": "string"
}

Cable Test

Instruct the switch to perform cable diagnostics test.

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
ports
required
Array of integers (Ports)

Responses

Request samples

Content type
application/json
{
  • "ports": [
    ]
}

Response samples

Content type
application/json
{
  • "ports": [
    ]
}

Connectivity

This API returns the last 2hr/1d/7d/30d data of device connectivity status

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
required
ClientPeriod (string) or null

Responses

Request samples

Content type
application/json
{
  • "period": "2h"
}

Response samples

Content type
application/json
[
  • {
    }
]

Get Site Clients V2

This API returns the last 2hr/1d/7d/30d data of site-wide clients.
Response data key is macAddress.

path Parameters
siteId
required
string (Siteid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
required
ClientPeriod (string) or null

default is 2h

featrues
required
Array of strings (Featrues)
Items Enum: "mac_address" "ipv4" "vlan" "last_seen" "connected_device_id" "status" "first_seen" "description" "os_hostname" "manufacturer"

Responses

Request samples

Content type
application/json
{
  • "period": "2h",
  • "featrues": [
    ]
}

Response samples

Content type
application/json
{
  • "KeyFields": [
    ],
  • "data": [
    ]
}

Get Ap Clients V2

This API returns the last 2hr/1d/7d/30d data of AP clients.
Response data key is macAddress.

path Parameters
siteId
required
string (Siteid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
required
ClientPeriod (string) or null

default is 2h

featrues
required
Array of strings (Featrues)
Items Enum: "mac_address" "ipv4" "last_seen" "connected_device_id" "first_seen" "description" "os_hostname" "manufacturer" "ssid" "wifi_sta" "user" "upload" "download"

Responses

Request samples

Content type
application/json
{
  • "period": "2h",
  • "featrues": [
    ]
}

Response samples

Content type
application/json
{
  • "KeyFields": [
    ],
  • "data": [
    ]
}

Get Sw Clients V2

This API returns the last 2hr/1d/7d/30d data of SW clients.
Response data key is macAddress and vlan.

path Parameters
siteId
required
string (Siteid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
required
ClientPeriod (string) or null

default is 2h

featrues
required
Array of strings (Featrues)
Items Enum: "mac_address" "ipv4" "last_seen" "connected_device_id" "first_seen" "description" "manufacturer" "vlan" "lldp_info"

Responses

Request samples

Content type
application/json
{
  • "period": "2h",
  • "featrues": [
    ]
}

Response samples

Content type
application/json
{
  • "KeyFields": [
    ],
  • "data": [
    ]
}

Get Gw Clients V2

This API returns the last 2hr/1d/7d/30d data of GW clients.
Firewall Respone data key is macAddress and ipv4Address and interface.
SCR Respone data key is macAddress.

path Parameters
siteId
required
string (Siteid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
required
ClientPeriod (string) or null

default is 2h

featrues
required
Array of strings (Featrues)
Items Enum: "mac_address" "ipv4" "last_seen" "connected_device_id" "first_seen" "description" "os_hostname" "manufacturer" "interface"

Responses

Request samples

Content type
application/json
{
  • "period": "2h",
  • "featrues": [
    ]
}

Response samples

Content type
application/json
{
  • "KeyFields": [
    ],
  • "data": [
    ]
}

ap

AP operations

Get Access Point Ip Status

This API returns the current IP status (instead of configuration) of AP interfaces.

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Access Point Port Status

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Wlan Settings

Note: This API always returns 8 SSIDs.

path Parameters
siteId
required
string (Siteid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Patch Wlan Settings

Note: currently this API only supports PSK For [PATCH] method on wlan-setting API, it will only update the SSID Pre-Shared-Key (PSK), no matter the SSID security mode is WPA2/3 or not.

path Parameters
siteId
required
string (Siteid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
Array
id
required
integer (Id) ( 0 .. 8 ]

Index from 1 to 8

wpaKey
required
string (Wpakey)

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "status": 0,
  • "message": "string"
}

Ap Logout User

Logout AP users in the site. Every AP will be instructed to logout the users.

path Parameters
siteId
required
string (Siteid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

sw

Switch operations

Get Switch Lldp Neighbor

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Switch Ip Status

This API returns the current IP status (instead of configuration) of Switch. Currently, only one IP will be returned in the array.

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Switch L2 Mac Table

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Switch Port Status

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Switch Port Setting

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Change Switch Port Setting

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
portNum
required
integer (Portnum)
enabled
required
boolean (Enabled)
trunk
required
boolean (Trunk)
portVid
required
integer (Portvid)
allowedVLAN
required
Array of strings (Allowedvlan)
required
Pseenabled (boolean) or Pseenabled (null) (Pseenabled)

Responses

Request samples

Content type
application/json
{
  • "portNum": 0,
  • "enabled": true,
  • "trunk": true,
  • "portVid": 0,
  • "allowedVLAN": [
    ],
  • "pseEnabled": true
}

Response samples

Content type
application/json
{
  • "status": 0,
  • "message": "string"
}

Get Switch Poe Status

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Switch Traffic Usage

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
query Parameters
period
string (Period)
Default: "1d"
Enum: "2h" "1d" "7d"
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Sw Event Logs

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
startTimestamp
required
integer (Starttimestamp)

unit: Unix timestamp (ms)

endTimestamp
required
integer (Endtimestamp)

unit: Unix timestamp (ms)

Responses

Request samples

Content type
application/json
{
  • "startTimestamp": 0,
  • "endTimestamp": 0
}

Response samples

Content type
application/json
[
  • {
    }
]

Get Switch Uplink Port

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
{
  • "portNum": 0
}

gw

Secure Gateway (NSG*/USG FLEX) operations

Get Gateway Port Status

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Gateway System Status

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
{
  • "cpuUsage": 0,
  • "memUsage": 0,
  • "sessions": 0
}

Get Secure Gateway Traffic Usage

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
query Parameters
period
string (Period)
Default: "1d"
Enum: "2h" "1d" "7d"
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Gateway Event Logs

path Parameters
siteId
required
string (Siteid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)
Request Body schema: application/json
required
startTimestamp
required
integer (Starttimestamp)

unit: Unix timestamp (ms)

endTimestamp
required
integer (Endtimestamp)

unit: Unix timestamp (ms)

Responses

Request samples

Content type
application/json
{
  • "startTimestamp": 0,
  • "endTimestamp": 0
}

Response samples

Content type
application/json
[
  • {
    }
]

Get Firewall Nat Settings

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
{
  • "oneToOne": [
    ],
  • "virtualServer": [
    ]
}

Get Firewall Interface Settings

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
{
  • "wan": [
    ],
  • "lan": [
    ]
}

wwan

WWAN (Mobile Router) operations

Get Wwan Device Status

This API returns the Mobile Router WWAN Status.

path Parameters
siteId
required
string (Siteid)
devId
required
string (Devid)
header Parameters
X-ZyxelNebula-API-Key
required
string (X-Zyxelnebula-Api-Key)

Responses

Response samples

Content type
application/json
{
  • "ipv4Address": "192.168.0.1",
  • "imei": "string",
  • "iccid": "string",
  • "rsrp": 0
}