Skip to content
Tool to browse data exposed by Ubiquiti's UniFi Controller API (demo: https://api-browser-demo.artofwifi.net/)
PHP HTML JavaScript CSS
Branch: master
Clone or download

Latest commit

malle-pietje UniFi API browser 2.0.9
- executed composer update to update packages
- upgraded PHP API client to version 1.1.52
- minor changes
- added max. tx/rx-rates attributes to fetch for the gateway stats
Latest commit fbade73 Apr 14, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
ajax UniFi API browser 2.0.9 Apr 14, 2020
config UniFi API browser 2.0.9 Apr 14, 2020
css UniFi API browser 2.0.0 Oct 25, 2019
js UniFi API browser 2.0.9 Apr 14, 2020
templates UniFi API browser 2.0.9 Apr 14, 2020
vendor UniFi API browser 2.0.9 Apr 14, 2020
.gitignore UniFi API browser 2.0.0 Oct 25, 2019
LICENSE.md Applied changes to wording related to the repository transfer, no fun… Aug 17, 2017
README.md UniFi API browser 2.0.9 Apr 14, 2020
TODO.md UniFi API browser 2.0.0 Oct 25, 2019
collections.php UniFi API browser 2.0.9 Apr 14, 2020
common.php UniFi API browser 2.0.9 Apr 14, 2020
composer.json UniFi API browser 2.0.3 Oct 31, 2019
composer.lock UniFi API browser 2.0.9 Apr 14, 2020
favicon.ico UniFi API browser 2.0.0 Oct 25, 2019
index.php UniFi API browser 2.0.5 Dec 7, 2019
login.php UniFi API browser 2.0.0 Oct 25, 2019
logout.php UniFi API browser 2.0.0 Oct 25, 2019

README.md

UniFi API browser

This tool is for browsing data that is exposed through Ubiquiti's UniFi Controller API, written in PHP, JavaScript and the Bootstrap CSS framework.

It comes bundled with a PHP class for access to the UniFi Controller API, which supports more API endpoints than the UniFi API browser tool does.

If you plan on creating your own PHP code to leverage the UniFi controller API, it is recommended to use the standalone version of the API client class which can be found here: https://github.com/Art-of-WiFi/UniFi-API-client

You will find examples and detailed instructions there.

Please keep the following in mind:

  • the API browser tool doesn't support all available data collections/API endpoints, see the list below of those that are currently supported
  • currently, versions 4.x.x and 5.x.x of the UniFi Controller software are supported (version 5.12.66 has been confirmed to work) as well as UbiOS-based controllers (version 5.12.59 has been confirmed to work)
  • when accessing UbiOS-based controllers (e.g. UDM PRO) through this tool, please read the remarks below regarding UbiOS support
  • there is still work to be done to add/improve functionality and usability of this tool so suggestions/comments are welcome. Please use the GitHub issue list or the Ubiquiti Community forums (https://community.ubnt.com/t5/UniFi-Wireless/UniFi-API-browser-tool-released/m-p/1392651) to share your ideas/questions.
  • please read the Security Notice below before installing this tool!

Demo

A demo version that is connected to Ubiquiti's demo controller is available here: https://api-browser-demo.artofwifi.net/

Upgrading from 1.X to 2.X

Because the structure of the configuration file has changed, we recommend creating a fresh install when upgrading from 1.X to 2.X.

Features

The UniFi API browser tool offers the following features:

  • browse data collections/API endpoints exposed by the UniFi Controller API in an easy manner
  • switch between sites managed by the connected controller
  • switch between output formats (currently JSON, JSON highlighted, PHP array, interactive and PHP array, highlighted have been implemented)
  • copy the results to clipboard (this is only supported with the JSON output format, will fail gracefully with large collections)
  • switch between default Bootstrap theme and the Bootswatch themes
  • an "About" modal which shows version information for PHP, cURL and the UniFi Controller
  • very easy setup with minimal dependencies
  • timing details of API calls can be useful to "benchmark" your UniFi Controller
  • useful tool when developing applications that make use of the UniFi Controller API
  • the API exposes more data than is visible through the UniFi controller's web interface which makes the tool useful for troubleshooting purposes
  • debug mode to troubleshoot cURL connections (set $debug to true in the config file to enable debug mode)

Data collections/API endpoints currently implemented in the API browser

  • Clients/users
    • list online clients
    • list guests
    • list users
    • list user groups
    • stat all users
    • stat authorisations
    • stat sessions
  • Devices
    • list devices (access points, USG routers and USW switches)
    • list wlan groups
    • list rogue access points
    • list_known_rogueaps
    • list devices tags (supported on controller version 5.5.19 and higher)
  • Stats
    • hourly site stats
    • daily site stats
    • hourly access point stats
    • daily access point stats
    • all sites stats
    • health metrics
    • dashboard metrics
    • port forward stats
  • Hotspot
    • stat vouchers
    • stat payments
    • list hotspot operators
  • Configuration
    • list sites on this controller
    • list site settings
    • list admins for current site
    • sysinfo
    • self
    • list wlan config
    • list VoIP extension
    • list network configuration
    • list port configurations
    • list port forwarding rules
    • list firewall groups
    • list current channels
    • list DPI stats
    • dynamic DNS configuration
    • list country codes
    • list Radius accounts (supported on controller version 5.5.19 and higher)
  • Messages
    • list events
    • list alarms
    • count alarms

Please note that the bundled API client supports many more API endpoints, not all make sense to add to the API browser though.

Requirements

  • a web server with PHP and cURL modules installed (confirmed to work on Apache with PHP Version 5.6.32 and cURL 7.29.0 and with PHP 7.2.5 and cURL 7.60.0)
  • network connectivity between this web server and the server (and port) where the UniFi controller is running (in case you are seeing errors, please check out this issue)
  • clients using this tool should have internet access because several CSS and JS files are loaded from public CDNs.

Installation

Installation of this tool is quite straightforward. The easiest way to do this is by using git clone which also allows for easy updates:

  • open up a terminal window on your server and cd to the root folder of your web server (on Ubuntu this is /var/www/html) and execute the following command from your command prompt:
git clone https://github.com/Art-of-WiFi/UniFi-API-browser.git
  • when git is done cloning, follow the configuration steps below to configure the settings for access to your UniFi Controller's API

Alternatively you may choose to download the zip file and unzip it in your directory of choice, then follow the configuration steps below.

Installation using Docker

@scyto maintains Docker containers for quick and easy deployment of the UniFi API browser tool. Please refer to this Wiki page within the repository for more details:

Configuration

  • credentials for access to the UniFi Controller API are configured in the file named config/config-template.php which should be copied/renamed to config/config.php
  • starting with version 1.0.3, you can store multiple controller configurations in an array inside the config/config.php file
  • please refer to the instructions in the config/config-template.php file for further configuration instructions
  • starting with API browser tool version 2.0.0 you can restrict access to the tool by creating user accounts and passwords, please refer to the instructions in the config/users-template.php file for further details
  • after following these steps, you can open the tool in your browser (assuming you installed it in the root folder of your web server as suggested above) by going to this url: http(s)://<server IP address>/UniFi-API-browser/

UbiOS support

Support for UbiOS-based controllers (UniFi Dream Machine Pro) has been added with version 2.0.7. When adding the details for a UbiOS device to the config/config.php file, please make sure not to add a port suffix or trailing slashes to the URL.

Extending the dropdown menu

Since version 2.0.0 you can extend the dropdown menu with your own options by adding them to the config.php file. Here's an example:

/**
 * adding a custom sub menu example
 */
$collections = array_merge($collections, [
    [
        'label' => 'Custom Menu', // length of this string is limited due to dropdown menu width
        'options' => [
            [
                'type' => 'collection', // either collection or divider
                'label' => 'hourly site stats past 24 hours', // string that is displayed in the dropdown menu
                'method' => 'stat_hourly_site', // the method/function in the API client class that is called
                'params' => [(time() - (24 * 60 *60)) * 1000, time() * 1000], // an array containing the parameters that are passed to the method/function
                'key' => 'custom_0' // unique key for this menu option, may be required for future versions
            ],
            [
                'type' => 'collection',
                'label' => 'daily site stats past 31 days',
                'method' => 'stat_daily_site',
                'params' => [(time() - (31 * 24 * 60 *60)) * 1000, time() * 1000],
                'key' => 'custom_1'
            ],
            [
                'type' => 'divider', // dividers have no other properties
            ],
            [
                'type' => 'collection',
                'label' => 'enable the site LEDs',
                'method' => 'site_leds', // don't go wild when adding such calls, this example is simply to show the flexibility
                'params' => [true],
                'key' => 'custom_2'
            ],
            [
                'type' => 'collection',
                'label' => 'disable the site LEDs',
                'method' => 'site_leds', // don't go wild when adding such calls, this example is simply to show the flexibility
                'params' => [false],
                'key' => 'custom_3'
            ],
        ],
    ],
]);

Note: for a collection type menu option the type, label, method, params and key "properties" are required.

This is what the result looks like:

Custom sub menu

Updates

If you have installed the tool using the git clone command, you can install updates by going into the directory where the tool has been installed, and running the git pull command from there.

Otherwise you can simply copy the contents from the latest zip file to the directory where the tool has been installed.

Credits

The PHP API client that comes bundled with this tool is based on the work by the following developers:

and the API as published by Ubiquiti:

Other included libraries:

Security notice

We highly recommend enabling the user name/password authentication feature by creating a config/users.php based on the included config/users-template.php file. When creating passwords and their SHA512 hashes for entry in the config/users.php file, please make sure to use strong random passwords.

Please refer to the instructions in the config/users-template.php file for further details

It is your own responsibility to implement the necessary additional controls in securing this application and preventing unwanted access.

Screenshots

Here are a couple of screenshots of the tool in action.

The Login form when user authentication is enabled:

Login form

The controller selection dropdown menu:

Controller selection

The site selection dropdown menu:

Site selection

The collection dropdown menu:

Select collection

Showing the site settings collection in JSON format:

Site settings in JSON format

Showing the site settings collection in interactive PHP format:

Site settings in PHP format

The "About" modal:

About modal

You can’t perform that action at this time.