mirror of
https://github.com/Art-of-WiFi/UniFi-API-client.git
synced 2024-11-21 17:49:59 +01:00
bf3446bba0
- added information to several docblocks
- changed handling of request headers, added private property for this
- applied changes for improved use of require_once in the README and examples
- added `list_sites()` example
- *potential breaking changes:*
renamed `get_request_type()` and `set_request_type()` functions/methods to `get_request_method()` and `set_request_method()` respectively
60 lines
1.6 KiB
PHP
Executable File
60 lines
1.6 KiB
PHP
Executable File
<?php
|
|
/**
|
|
* PHP API usage example
|
|
*
|
|
* contributed by: Art of WiFi
|
|
* description: example PHP script to perform a basic auth of a guest device
|
|
*/
|
|
|
|
/**
|
|
* using the composer autoloader
|
|
*/
|
|
require_once 'vendor/autoload.php';
|
|
|
|
/**
|
|
* include the config file (place your credentials etc. there if not already present)
|
|
* see the config.template.php file for an example
|
|
*/
|
|
require_once 'config.php';
|
|
|
|
/**
|
|
* the MAC address of the device to authorize
|
|
*/
|
|
$mac = '<enter MAC address of guest device to auth>';
|
|
|
|
/**
|
|
* the MAC address of the Access Point the guest is currently connected to, enter null (without quotes)
|
|
* if not known or unavailable
|
|
*
|
|
* NOTE:
|
|
* although the AP MAC address is not a required parameter for the authorize_guest() function,
|
|
* adding this parameter will speed up the initial authorization process
|
|
*/
|
|
$ap_mac = '<enter MAC address of Access Point>';
|
|
|
|
/**
|
|
* the duration to authorize the device for in minutes
|
|
*/
|
|
$duration = 2000;
|
|
|
|
/**
|
|
* The site to authorize the device with
|
|
*/
|
|
$site_id = '<enter your site id here>';
|
|
|
|
/**
|
|
* initialize the UniFi API connection class and log in to the controller
|
|
*/
|
|
$unifi_connection = new UniFi_API\Client($controlleruser, $controllerpassword, $controllerurl, $site_id, $controllerversion);
|
|
$set_debug_mode = $unifi_connection->set_debug($debug);
|
|
$loginresults = $unifi_connection->login();
|
|
|
|
/**
|
|
* then we authorize the device for the requested duration
|
|
*/
|
|
$auth_result = $unifi_connection->authorize_guest($mac, $duration, null, null, null, $ap_mac);
|
|
|
|
/**
|
|
* provide feedback in json format
|
|
*/
|
|
echo json_encode($auth_result, JSON_PRETTY_PRINT); |