uWaterloo / OpenData

Help and Support for University of Waterloo Open Data Initiative
https://api.uwaterloo.ca
90 stars 12 forks source link

Endpoint for IST wifi-charts data #181

Closed a1gemmel closed 7 years ago

a1gemmel commented 7 years ago

I'd like to have endpoints for the wifi-charts data that IST offers. I'm interested in doing some data analysis and building heatmaps for the data usage on campus.

zachomedia commented 7 years ago

Thanks @a1gemmel for the request. This is data we would like to have in the Open Data API, but I cannot offer an ETA at this time. Once I have more information regarding WiFi charts data, I'll let you know.

srcreigh commented 7 years ago

any updates here? :)

zachomedia commented 7 years ago

Hello @a1gemmel, @srcreigh and others:

I have a beta of the endpoints available now in the API. Documentation for the endpoints is still pending, but here's a quick highlight:

Usage

Wireless usage information, updated every 15 minutes. Rates are reported in bits per second (bps).

Clients

Returns a breakdown of clients who have connected to wireless. Groups are based on operating system and radio mode. This data is updated once daily.

Authentication Issues

This endpoint will return the number of authentication issues. The endpoint is currently unavailable.

Rogues

Returns the number of rogue access points detected. Data is updated every 15 minutes.

Historical Data

All endpoints also have a separate endpoint to fetch historical data. Data is available for the past 30 days (number of days to retain has not been finalised).

All historical endpoints have two mandatory query string parameters: from and to. These are date/time values provided in ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDThhmmss(+|-)hhmm). These endpoints will return all data points within the requested times.


There are some known issues that occasionally result in stale data. Let me know if you experience any issues or have any comments/feedback.

KartikTalwar commented 7 years ago

woo!

zachomedia commented 7 years ago

Full documentation is now available: https://github.com/uWaterloo/api-documentation#wireless