Help Needed: Omada SDN Controller v5.15.20.18 North‑bound API – Sites, Clients & Quotas
Hi all, I’m automating our captive‑portal on an on‑prem Omada SDN Controller (v5.15.20.18) and hitting roadblocks. Here’s the TL;DR:
What Works
-
GET /api/info
→ returnsomadacId
-
POST /{omadacId}/api/v2/login
→ returns CSRF token + session cookie -
POST /{omadacId}/api/v2/hotspot/extPortal/auth
→ successfully authenticates a client for a specified time
What Fails
-
Listing Sites
GET /{omadacId}/api/v2/sites → { "errorCode": -1, "msg": "General error." }
-
Listing Connected Clients + Usage
GET /{omadacId}/api/v2/sites/{siteId}/clients?currentPage=1¤tPageSize=1000 → { "errorCode": -1, "msg": "General error." }
-
De‑authenticating a Client
No/deauth
endpoint exists in docs. -
Enforcing a Data Quota
Would like to passtotalQuota
(bytes) to/hotspot/extPortal/auth
but no documented support.
What I’ve Tried
-
Both internal north‑bound API v2 and attempted v3 (per
apiVer
in/api/info
) -
Cloud Open API (
use1-omada-northbound.tplinkcloud.com
) with correct client ID/secret & roles (error −44116)
Questions
-
What are the exact API endpoints (and version) to list sites and list clients + their up/down traffic?
-
How do I disconnect a captive‑portal client via API?
-
Is there a way to specify a data quota when authenticating a client?
-
Any cURL examples or JSON payload samples would be hugely appreciated!
Thanks in advance for any pointers!