Connectez votre voiture a votre Domotique avec XeeConnect

<?php
 
define('XEE_API_CLIENT_ID', 'votreclientid');
define('XEE_API_SECRET_ID', 'votresecretid');
define('XEE_API_REDIRECT_URI', 'http://votre-serveur.com/le/chemin/de/votre/script/php');
 
define('XEE_API_DEFAULT_URL', 'https://cloud.xee.com/v3/');
 
/**
 * get data from the web service
 * @return array agreggation from all results
 */
function getData()
{
    $totalResults              = array();
    $totalResults['token']     = getAccessToken();
    $totalResults['user']      = getUserData($totalResults['token']['access_token']);
    $totalResults['car']       = getCarData($totalResults['token']['access_token'], $totalResults['user']['id']);
    $totalResults['carStatus'] = getCarStatusData($totalResults['token']['access_token'], $totalResults['car']['id']);
 
    return $totalResults;
}
 
/**
 * get connected user data
 * @param  string $accessToken access token
 * 
 * @return array all informations about me
 */
function getUserData($accessToken)
{
    return getRequest(
        XEE_API_DEFAULT_URL . 'users/me', 
        $httpHeaders = array(
            'authorization: Bearer ' . $accessToken,
            'cache-control: no-cache'
        )
    );
}
 
/**
 * get user's car data
 * @param  string $accessToken access token
 * @param  int    $userId      car's owner
 * 
 * @return array all informations about the first car
 */
function getCarData($accessToken, $userId)
{
    $carData = getRequest(
        XEE_API_DEFAULT_URL . 'users/' . $userId . '/cars', 
        $httpHeaders = array(
            'authorization: Bearer ' . $accessToken,
            'cache-control: no-cache'
        )
    );
    //get only the first car
    return $carData[0];
}
 
/**
 * get car status
 * @param  string $accessToken access token
 * @param  int    $carId       car id
 * 
 * @return array all informations about car status
 */
function getCarStatusData($accessToken, $carId)
{
    $carStatusData = getRequest(
        XEE_API_DEFAULT_URL . 'cars/' . $carId . '/status', 
        $httpHeaders = array(
            'authorization: Bearer ' . $accessToken,
            'cache-control: no-cache'
        )
    );
 
    return $carStatusData;
}
 
/**
 * automatic switch to get the first token from first connection
 * or to get a fresh token from the web service
 * @return array access token, refresh token and expiration date
 */
function getAccessToken()
{
    if (isset($_GET['token']) && !empty($_GET['token'])) {
        return getFreshToken($_GET['token']);
    } elseif (isset($_GET['code']) && !empty($_GET['code'])) {
        return getToken($_GET['code']);
    }
 
    firstConnection();
}
 
/**
 * get an access token and a new refresh token from a refresh token
 * @param  string $refreshToken current refresh token
 * @return array access token, refresh token and expiration date 
 */
function getFreshToken($refreshToken)
{
    return getToken($refreshToken, 'refresh_token');
}
 
/**
 * generic function to get a token
 * @param  string $key  authorization code or refresh token
 * @param  string $type grant type 
 * 
 * @return array access token, refresh token and expiration date
 */
function getToken($key, $type = '')
{
    switch ($type) {
        case 'refresh_token':
            $parameters = 'grant_type=refresh_token&refresh_token=' . $key;
            break;
 
        default:
            $parameters = 'grant_type=authorization_code&code=' . $key;
            break;
    }
 
    return postRequest(
        XEE_API_DEFAULT_URL . 'auth/access_token', 
        $parameters, 
        $httpHeaders = array(
            'authorization: Basic ' . base64_encode(XEE_API_CLIENT_ID . ':' . XEE_API_SECRET_ID),
            'cache-control: no-cache',
            'content-type: application/x-www-form-urlencoded'
        )
    );
}
 
/**
 * first Connection to the webservice with an Oauth authentification
 */
function firstConnection()
{
    $urlParams = array(
        'client_id'    => XEE_API_CLIENT_ID,
        'scope'        => 'users_read cars_read trips_read signals_read locations_read status_read',
        'redirect_uri' => XEE_API_REDIRECT_URI
    );
 
    header('Location: ' . XEE_API_DEFAULT_URL . 'auth/auth?' . http_build_query($urlParams));
    die;
}
 
/**
 * do a request with POST method
 * @param  string $url         url do do the request
 * @param  string $postFields  keys/values to POST
 * @param  array  $httpHeaders additionnal HTTP headers
 * 
 * @return array json decoded request result
 */
function postRequest($url, $postFields, $httpHeaders = array())
{
    return sendRequest($url, $requestType = 'POST', $postFields, $httpHeaders);
}
 
/**
 * do a request with GET method
 * @param  string $url         url do do the request
 * @param  array  $httpHeaders additionnal HTTP headers
 * 
 * @return array json decoded request result 
 */
function getRequest($url, $httpHeaders = array())
{
    return sendRequest($url, $requestType = 'GET', $postFields = '', $httpHeaders);
}
 
/**
 * generic function to make curl request
 * @param  string $url         url do do the request
 * @param  string $requestType request type : GET or POST
 * @param  string $postFields  keys/values urlencoded for POST method
 * @param  array  $httpHeaders additionnal HTTP headers
 * 
 * @return array json decoded request result
 */
function sendRequest($url, $requestType = 'GET', $postFields = '', $httpHeaders = array())
{
    $curl = curl_init();
 
    curl_setopt_array($curl, 
        array(
            CURLOPT_URL            => $url,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_ENCODING       => '',
            CURLOPT_MAXREDIRS      => 10,
            CURLOPT_TIMEOUT        => 30,
            CURLOPT_HTTP_VERSION   => CURL_HTTP_VERSION_1_1,
            CURLOPT_CUSTOMREQUEST  => $requestType,
            CURLOPT_POSTFIELDS     => $postFields,
            CURLOPT_HTTPHEADER     => $httpHeaders,
        )
    );
 
    $response = curl_exec($curl);
    $err      = curl_error($curl);
 
    curl_close($curl);
 
    if ($err) {
      die('cURL Error #:' . $err);
    } else {
        return json_decode($response, true);
    }
}
 
// display json encoded data
echo json_encode(getData());
exit;
?>