OMADA openapi calls demonstration

omanda.bash

### Bash Example
# set variables
OMADA_URL="https://omada:8043"
USERNAME="Viewer"
PASSWORD="grundlos"
CLIENT_ID="fb355d589ebf4b798415ca612d99819a" # from application list
CLIENT_SECRET="1c369a99a1574b5d8ed959c6e88b9565" # from application list
OMADA_ID="c491b4a4d05ff0d58282f4645848e9ec" # from view open api attributes

curl  -s "${OMADA_URL}/openapi/authorize/login?client_id=${CLIENT_ID}&omadac_id=${OMADA_ID}" \
	-H 'content-type:application/json' -d "{\"username\":\"${USERNAME}\",\"password\":\"${PASSWORD}\"}" -k --insecure > /tmp/login.json
CSRFTOKEN=$(cat /tmp/login.json | jq -r .result.csrfToken )
SESSIONID=$(cat /tmp/login.json | jq -r .result.sessionId )

cat /tmp/login.json | jq
echo "CSRFTOKEN=${CSRFTOKEN}"
echo "SESSIONID=${SESSIONID}"


curl  -s "${OMADA_URL}/openapi/authorize/code?client_id=${CLIENT_ID}&omadac_id=${OMADA_ID}&response_type=code" \
     -H 'content-type:application/json' -H "Csrf-Token:${CSRFTOKEN}" -H "Cookie:TPOMADA_SESSIONID=${SESSIONID}" -X POST -k --insecure > /tmp/authcode.json
AUTHCODE=$(cat /tmp/authcode.json | jq -r .result)
cat  /tmp/authcode.json | jq
echo "AUTHCODE=${AUTHCODE}"

curl  -s "${OMADA_URL}/openapi/authorize/token?grant_type=authorization_code&code=${AUTHCODE}" \
    -H 'content-type:application/json' -d "{\"client_id\": \"${CLIENT_ID}\", \"client_secret\": \"${CLIENT_SECRET}\"}" -X POST  -k --insecure > /tmp/token.json
ACCESSTOKEN=$(cat /tmp/token.json | jq -r .result.accessToken )
REFRESHTOKEN=$(cat /tmp/token.json | jq -r .result.refreshToken )

cat /tmp/token.json | jq
echo "ACCESSTOKEN=${ACCESSTOKEN}"
echo "REFRESHTOKEN=${REFRESHTOKEN}"

## example

curl -s "${OMADA_URL}/openapi/v1/${OMADA_ID}/sites?pageSize=1&page=1" -H 'content-type:application/json' -H "Authorization:AccessToken=${ACCESSTOKEN}" -X GET -k --insecure | jq

Thisi is a variation of this omada example, transcribed to the new openapi. The API documentation of the softwarecontroller is in https://<omadaserver>:8043/doc.html#/home.

I left a lot of echo and cat statements in the code to better see what is happening. Running this on my machine i get:

{
  "errorCode": 0,
  "msg": "Open API Log in successfully.",
  "result": {
    "csrfToken": "01ee52939f8f4a739304a8c3df021a8b",
    "sessionId": "d6bfeebe5df546b38cf1455f39cd71ba"
  }
}
CSRFTOKEN=01ee52939f8f4a739304a8c3df021a8b
SESSIONID=d6bfeebe5df546b38cf1455f39cd71ba
{
  "errorCode": 0,
  "msg": "Open API Authorize successfully.",
  "result": "OC-IAPAFH1wtx5fkZCfNNtKscnDRCYlfcXt"
}
AUTHCODE=OC-IAPAFH1wtx5fkZCfNNtKscnDRCYlfcXt
{
  "errorCode": 0,
  "msg": "Open API Get Access Token successfully.",
  "result": {
    "accessToken": "AT-uBtS3HaO3B6sFa7ajMIKnTJLwaecYzQS",
    "tokenType": "bearer",
    "expiresIn": 7200,
    "refreshToken": "RT-VhdGW51kbqLjS5aCd2PZEuCnLWtbdGC8"
  }
}
ACCESSTOKEN=AT-uBtS3HaO3B6sFa7ajMIKnTJLwaecYzQS
REFRESHTOKEN=RT-VhdGW51kbqLjS5aCd2PZEuCnLWtbdGC8
{
  "errorCode": 0,
  "msg": "Success.",
  "result": {
    "totalRows": 1,
    "currentPage": 1,
    "currentSize": 1,
    "data": [
      {
        "siteId": "660293f1ae766909a69251d4",
        "name": "FM174",
        "region": "Germany",
        "timeZone": "Europe/Amsterdam",
        "scenario": "Home",
        "type": 0
      }
    ]
  }
}

Theres no voucher or hotspot endpoints