Fulfill
your WiFi Dreams!
:}
Stay up to date with the WiFi Ninjas
Never miss a blog or podcast again!
Let’s face the truth. We can’t avoid dev stuff in WiFi forever! REST API, Python, JSON, Ansible and whatever else is needed – here we come!
It’s time. This is day 1 of our studies!
The mission for today? Actually we have a few 🙂
Extreeeemely complicated, we know 😉
Let’s assume everyone knows what the API is. In case it’s not the case, here is a quick read:
https://www.howtogeek.com/343877/what-is-an-api/
Mist (and most other Enterprise solutions) use REST:
Lastly, from Mist Documentation:
https://www.mist.com/documentation/category/api/
Steps to complete our little task below!
You can get it here:
https://www.getpostman.com/downloads/
Token is needed so the Mist Dash can authorize us to access API.
Log into Mist Dash, then go to and hit ‘POST’:
https://api.mist.com/api/v1/self/apitokens
If you hit ‘POST’ again, new token will be generated!
Take note of the “key” – it’s our token.
Let’s assume we want to list created WLANs in the test ‘WiFi Ninjas’ site.
Mist API is nicely documented. You can go to Mist API documentation page to check the URL for everything that’s possible using RESTful API:
https://api.mist.com/api/v1/docs/Home
We now know the syntax to get our WLANs.
Next we need to know the “WiFi Ninjas” Site ID to check against.
Go to Mist Dash. You can get Org ID and Site ID from the browser URL:
We now have everything we need to list our WLANs in ‘WiFi Ninjas’ site!
We should now see the details of just “WiFiNinjas(.)(.)” WLAN.
PS. We love that (.)(.) suffix!
Let’s rename “WiFiNinjas(.)(.)” to “WiFiNinjasTitties”! 🙂
Since we’re changing WLAN config, we’ll use PUT this time.
Change request type to PUT, go to “Body” tab, ensure “JSON” type is selected and write down lines that you want changed between curly brackets.
Note, that there is no comma at the end of the line.
You can now refresh your Mist Dash or GET the WLAN info via API to check if the name was changed.
Worked like charm! 🙂
Finally, we can use Postman to translate our actions into code (we’ll stick to Python), that can be used in scripts.
That’s it!
We have successfully listed all Mist WLANs, then narrowed it down to one WLAN and finally we’ve changed the name of that WLAN. All with REST API GET and PUT requests – how cool!
With love,
WiFi Ninjas x
Never miss a blog or podcast again!
Never miss a blog or podcast again!