route4me / route4me-php-sdk

src/Route4Me/V5/AddressBook/ResponseCluster.php

Indentation +27 added lines, -27 removed lines

@@ -15,33 +15,33 @@
  */
 class ResponseCluster extends Common
 {
-    /**
-     * Cluster of addresses
-     */
-    public ?Cluster $cluster = null;
+	/**
+	 * Cluster of addresses
+	 */
+	public ?Cluster $cluster = null;
 
-    /**
-     * A number of the returned addresses.
-     * @example 1
-     */
-    public ?int $address_count = null;
+	/**
+	 * A number of the returned addresses.
+	 * @example 1
+	 */
+	public ?int $address_count = null;
 
-    public function __construct(?array $params = null)
-    {
-        if ($params !== null) {
-            foreach ($this as $key => $value) {
-                if (isset($params[$key])) {
-                    if ($key === 'cluster') {
-                        if (is_array($params[$key])) {
-                            $this->{$key} = new Cluster($params[$key]);
-                        } elseif (is_object($params[$key]) && $params[$key] instanceof Cluster) {
-                            $this->{$key} = $params[$key];
-                        }
-                    } else {
-                        $this->{$key} = $params[$key];
-                    }
-                }
-            }
-        }
-    }
+	public function __construct(?array $params = null)
+	{
+		if ($params !== null) {
+			foreach ($this as $key => $value) {
+				if (isset($params[$key])) {
+					if ($key === 'cluster') {
+						if (is_array($params[$key])) {
+							$this->{$key} = new Cluster($params[$key]);
+						} elseif (is_object($params[$key]) && $params[$key] instanceof Cluster) {
+							$this->{$key} = $params[$key];
+						}
+					} else {
+						$this->{$key} = $params[$key];
+					}
+				}
+			}
+		}
+	}
 }

src/Route4Me/V5/AddressBook/Cluster.php

Indentation +27 added lines, -27 removed lines

@@ -13,35 +13,35 @@
  */
 class Cluster extends Common
 {
-    /**
-     * Geohash
-     * @example 1mr8h4r9
-     */
-    public ?string $geohash = null;
+	/**
+	 * Geohash
+	 * @example 1mr8h4r9
+	 */
+	public ?string $geohash = null;
 
-    /**
-     * Latitude
-     * @example -60.456132888793945
-     */
-    public ?float $lat = null;
+	/**
+	 * Latitude
+	 * @example -60.456132888793945
+	 */
+	public ?float $lat = null;
 
-    /**
-     * Longitude
-     * @example -60.456132888793945
-     */
-    public ?float $lng = null;
+	/**
+	 * Longitude
+	 * @example -60.456132888793945
+	 */
+	public ?float $lng = null;
 
-    /**
-     * Boundary box, array of pairs of floats.
-     * @var float[][]
-     * @example [[52.294921875, 5.2294921875], [52.3388671875, 5.2734375]]
-     */
-    public ?array $bbox = null;
+	/**
+	 * Boundary box, array of pairs of floats.
+	 * @var float[][]
+	 * @example [[52.294921875, 5.2294921875], [52.3388671875, 5.2734375]]
+	 */
+	public ?array $bbox = null;
 
-    public function __construct(?array $params = null)
-    {
-        if ($params !== null) {
-            $this->fillFromArray($params);
-        }
-    }
+	public function __construct(?array $params = null)
+	{
+		if ($params !== null) {
+			$this->fillFromArray($params);
+		}
+	}
 }

src/Route4Me/V5/AddressBook/ScheduleItem.php

Indentation +20 added lines, -20 removed lines

@@ -13,27 +13,27 @@
  */
 class ScheduleItem extends Common
 {
-    /**
-     * If true, the schedule is enabled.
-     */
-    public ?bool $enable = null;
+	/**
+	 * If true, the schedule is enabled.
+	 */
+	public ?bool $enable = null;
 
-    /**
-     * Schedule mode.
-     * @example 'monthly'
-     */
-    public ?string $mode = null;
+	/**
+	 * Schedule mode.
+	 * @example 'monthly'
+	 */
+	public ?string $mode = null;
 
-    /**
-     * Monthly properties.
-     * @example ['every' => 1]
-     */
-    public ?array $monthly = null;
+	/**
+	 * Monthly properties.
+	 * @example ['every' => 1]
+	 */
+	public ?array $monthly = null;
 
-    public function __construct(?array $params = null)
-    {
-        if ($params !== null) {
-            $this->fillFromArray($params);
-        }
-    }
+	public function __construct(?array $params = null)
+	{
+		if ($params !== null) {
+			$this->fillFromArray($params);
+		}
+	}
 }

src/Route4Me/V5/AddressBook/Address.php

Indentation +30 added lines, -30 removed lines

@@ -14,34 +14,34 @@
  */
 class Address extends ResponseAddress
 {
-    /**
-     * @param array|string $params_or_address_1  - The route Address Line 1 or array of Address's values.
-     * @param float        $cached_lat           - A latitude of the contact's cached position.
-     * @param float        $cached_lng           - A longitude of the contact's cached position.
-     * @param string       $address_stop_type    - The contact's stop type. available types:
-     *                                             'DELIVERY', 'PICKUP', 'BREAK', 'MEETUP',
-     *                                             'SERVICE', 'VISIT', 'DRIVEBY'
-     */
-    public function __construct(
-        $params_or_address_1,
-        ?float $cached_lat = null,
-        ?float $cached_lng = null,
-        ?string $address_stop_type = null
-    ) {
-        if (is_array($params_or_address_1) && isset($params_or_address_1['address_1'])
-            && isset($params_or_address_1['cached_lat']) && isset($params_or_address_1['cached_lng'])
-            && isset($params_or_address_1['address_stop_type'])
-        ) {
-            parent::__construct($params_or_address_1);
-        } elseif (is_string($params_or_address_1) && $params_or_address_1 != ""
-            && !is_null($cached_lat) && !is_null($cached_lng) && !is_null($address_stop_type)
-        ) {
-            $this->address_1 = $params_or_address_1;
-            $this->cached_lat = $cached_lat;
-            $this->cached_lng = $cached_lng;
-            $this->address_stop_type = $address_stop_type;
-        } else {
-            throw new ApiError('The fields address_1, cached_lat, cached_lng, address_stop_type are required.');
-        }
-    }
+	/**
+	 * @param array|string $params_or_address_1  - The route Address Line 1 or array of Address's values.
+	 * @param float        $cached_lat           - A latitude of the contact's cached position.
+	 * @param float        $cached_lng           - A longitude of the contact's cached position.
+	 * @param string       $address_stop_type    - The contact's stop type. available types:
+	 *                                             'DELIVERY', 'PICKUP', 'BREAK', 'MEETUP',
+	 *                                             'SERVICE', 'VISIT', 'DRIVEBY'
+	 */
+	public function __construct(
+		$params_or_address_1,
+		?float $cached_lat = null,
+		?float $cached_lng = null,
+		?string $address_stop_type = null
+	) {
+		if (is_array($params_or_address_1) && isset($params_or_address_1['address_1'])
+			&& isset($params_or_address_1['cached_lat']) && isset($params_or_address_1['cached_lng'])
+			&& isset($params_or_address_1['address_stop_type'])
+		) {
+			parent::__construct($params_or_address_1);
+		} elseif (is_string($params_or_address_1) && $params_or_address_1 != ""
+			&& !is_null($cached_lat) && !is_null($cached_lng) && !is_null($address_stop_type)
+		) {
+			$this->address_1 = $params_or_address_1;
+			$this->cached_lat = $cached_lat;
+			$this->cached_lng = $cached_lng;
+			$this->address_stop_type = $address_stop_type;
+		} else {
+			throw new ApiError('The fields address_1, cached_lat, cached_lng, address_stop_type are required.');
+		}
+	}
 }

src/Route4Me/V5/AddressBook/StatusChecker.php

Indentation +33 added lines, -33 removed lines

@@ -13,37 +13,37 @@
  */
 class StatusChecker extends Common
 {
-    /**
-     * HTTP code.
-     * @example 200, 202
-     */
-    public ?int $code = null;
-
-    /**
-     * Requested data if request was handled synchronously.
-     * @example ['status' => 1] - Successful operation
-     */
-    public ?array $data = null;
-
-    /**
-     * Path to the status checker if request was handled asynchronously.
-     */
-    public ?string $location = null;
-
-    /**
-     * Job Id to check status if request was handled asynchronously.
-     */
-    public ?string $x_job_id = null;
-
-    /**
-     * Job running time in seconds.
-     */
-    public ?string $x_r4m_async_job_running_time = null;
-
-    public function __construct(?array $params = null)
-    {
-        if ($params !== null) {
-            $this->fillFromArray($params);
-        }
-    }
+	/**
+	 * HTTP code.
+	 * @example 200, 202
+	 */
+	public ?int $code = null;
+
+	/**
+	 * Requested data if request was handled synchronously.
+	 * @example ['status' => 1] - Successful operation
+	 */
+	public ?array $data = null;
+
+	/**
+	 * Path to the status checker if request was handled asynchronously.
+	 */
+	public ?string $location = null;
+
+	/**
+	 * Job Id to check status if request was handled asynchronously.
+	 */
+	public ?string $x_job_id = null;
+
+	/**
+	 * Job running time in seconds.
+	 */
+	public ?string $x_r4m_async_job_running_time = null;
+
+	public function __construct(?array $params = null)
+	{
+		if ($params !== null) {
+			$this->fillFromArray($params);
+		}
+	}
 }

src/Route4Me/V5/AddressBook/ResponseAll.php

Indentation +36 added lines, -36 removed lines

@@ -14,43 +14,43 @@
  */
 class ResponseAll extends Common
 {
-    /**
-     * Array of ResponceAddresses.
-     * @var ResponceAddress[]
-     */
-    public ?array $results = null;
+	/**
+	 * Array of ResponceAddresses.
+	 * @var ResponceAddress[]
+	 */
+	public ?array $results = null;
 
-    /**
-     * Total quantity of ResponceAddresses that match the query.
-     * @example 1
-     */
-    public ?int $total = null;
+	/**
+	 * Total quantity of ResponceAddresses that match the query.
+	 * @example 1
+	 */
+	public ?int $total = null;
 
-    /**
-     * An array of valid fields name in results array.
-     * @var string[]
-     */
-    public ?array $fields = null;
+	/**
+	 * An array of valid fields name in results array.
+	 * @var string[]
+	 */
+	public ?array $fields = null;
 
-    public function __construct(?array $params = null)
-    {
-        if ($params !== null) {
-            foreach ($this as $key => $value) {
-                if (isset($params[$key])) {
-                    if ($key === 'results') {
-                        $this->{$key} = array();
-                        foreach ($params[$key] as $ra_key => $ra_value) {
-                            if (is_array($ra_value)) {
-                                array_push($this->{$key}, new ResponseAddress($ra_value));
-                            } elseif (is_object($ra_value) && $ra_value instanceof ResponseAddress) {
-                                array_push($this->{$key}, $ra_value);
-                            }
-                        }
-                    } else {
-                        $this->{$key} = $params[$key];
-                    }
-                }
-            }
-        }
-    }
+	public function __construct(?array $params = null)
+	{
+		if ($params !== null) {
+			foreach ($this as $key => $value) {
+				if (isset($params[$key])) {
+					if ($key === 'results') {
+						$this->{$key} = array();
+						foreach ($params[$key] as $ra_key => $ra_value) {
+							if (is_array($ra_value)) {
+								array_push($this->{$key}, new ResponseAddress($ra_value));
+							} elseif (is_object($ra_value) && $ra_value instanceof ResponseAddress) {
+								array_push($this->{$key}, $ra_value);
+							}
+						}
+					} else {
+						$this->{$key} = $params[$key];
+					}
+				}
+			}
+		}
+	}
 }

src/Route4Me/Route4Me.php

Indentation +363 added lines, -363 removed lines

@@ -7,367 +7,367 @@
 
 class Route4Me
 {
-    public static $apiKey;
-    public static $baseUrl = Endpoint::BASE_URL;
-
-    public static function setApiKey($apiKey)
-    {
-        self::$apiKey = $apiKey;
-    }
-
-    public static function getApiKey()
-    {
-        return self::$apiKey;
-    }
-
-    public static function setBaseUrl($baseUrl)
-    {
-        self::$baseUrl = $baseUrl;
-    }
-
-    public static function getBaseUrl()
-    {
-        return self::$baseUrl;
-    }
-
-    /**
-     * Make request with CURL
-     *
-     * @since 1.2.3 changed error handling
-     * @since 1.2.8 added $options['return_headers']
-     *
-     * @param array  $options
-     *   string url                        - HTTP URL.
-     *   string method                     - HTTP method.
-     *   string api_key                    - API key to access to route4me server.
-     *   array  query                      - Array of query parameters.
-     *   array  body                       - Array of body parameters.
-     *   string HTTPHEADER                 - Content type of body e.g.
-     *                                       'Content-Type: application/json'
-     *                                       'Content-Type: multipart/form-data'
-     *   array  HTTPHEADERS                - Array of headers.
-     *   string FILE                       - Path to uploading file.
-     *   array  return_headers             - Array of response headers to return as a result.
-     * @throws Exception\ApiError
-     */
-    public static function makeRequst($options)
-    {
-        $method = isset($options['method']) ? $options['method'] : 'GET';
-        $query = isset($options['query'])
-            ? array_filter($options['query'], function ($x) {
-                return !is_null($x);
-            }) : [];
-
-        $body = isset($options['body']) ? $options['body'] : null;
-        $file = isset($options['FILE']) ? $options['FILE'] : null;
-        $headers = [
-            'User-Agent: Route4Me php-sdk',
-        ];
-
-        $return_headers = (isset($options['return_headers']) ? $options['return_headers'] : null);
-
-        if (isset($options['HTTPHEADER'])) {
-            $headers[] = $options['HTTPHEADER'];
-        }
-
-        if (isset($options['HTTPHEADERS'])) {
-            foreach ($options['HTTPHEADERS'] as $header) {
-                $headers[] = $header;
-            }
-        }
-
-        $ch = curl_init();
-
-        $url = isset($options['url'])
-            ? $options['url'] . '?' . http_build_query(array_merge(
-                $query,
-                ['api_key' => self::getApiKey()]
-            )) : '';
-
-        $baseUrl = self::getBaseUrl();
-
-        $curlOpts = [
-            CURLOPT_URL             => $baseUrl.$url,
-            CURLOPT_RETURNTRANSFER  => true,
-            CURLOPT_TIMEOUT         => 120,
-            CURLOPT_FOLLOWLOCATION  => true,
-            CURLOPT_SSL_VERIFYHOST  => false,
-            CURLOPT_SSL_VERIFYPEER  => false,
-            CURLOPT_HTTPHEADER      => $headers,
-        ];
-
-        curl_setopt_array($ch, $curlOpts);
-
-        // read response headers if need
-        $response_headers = [];
-        if ($return_headers) {
-            curl_setopt($ch, CURLOPT_HEADERFUNCTION, function ($curl, $header) use (&$response_headers) {
-                $len = strlen($header);
-                $header = explode(':', $header, 2);
-                if (count($header) >= 2) {
-                    $response_headers[strtolower(trim($header[0]))] = trim($header[1]);
-                }
-                return $len;
-            });
-        }
-
-        if (null != $file) {
-            $cfile = new \CURLFile($file, '', '');
-            $body['strFilename']=$cfile;
-            curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
-            curl_setopt($ch, CURLOPT_POST, true);
-            curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
-        } else {
-            switch ($method) {
-                case 'DELETE':
-                    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
-                    break;
-                case 'DELETEARRAY':
-                    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
-                    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($query));
-                    break;
-                case 'PUT':
-                    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
-                    break;
-                case 'POST':
-                    if (isset($body)) {
-                        $bodyData = json_encode($body);
-                        if (isset($options['HTTPHEADER'])) {
-                            if (strpos($options['HTTPHEADER'], 'multipart/form-data') > 0) {
-                                $bodyData = $body;
-                            }
-                        }
-                        curl_setopt($ch, CURLOPT_POSTFIELDS, $bodyData);
-                    }
-                    break;
-                case 'ADD':
-                    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($query));
-                    break;
-                case 'PATCH':
-                    if (isset($body)) {
-                        $bodyData = json_encode($body);
-                        if (isset($options['HTTPHEADER'])) {
-                            if (strpos($options['HTTPHEADER'], 'multipart/form-data') > 0) {
-                                $bodyData = $body;
-                            }
-                        }
-                        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');
-                        curl_setopt($ch, CURLOPT_POSTFIELDS, $bodyData);
-                    }
-                    break;
-            }
-
-            if (is_numeric(array_search($method, ['DELETE', 'PUT']))) {
-                if (isset($body)) {
-                    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
-                }
-            }
-        }
-
-        $result = curl_exec($ch);
-        $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
-        curl_close($ch);
-
-        $json = null;
-        if (strpos($result, '<?xml') > -1) {
-            $xml = simplexml_load_string($result);
-            $json = self::object2array($xml);
-        } else {
-            $json = json_decode($result, true);
-        }
-        if (200 == $code || 201 == $code || 202 == $code) {
-            if (isset($json['errors'])) {
-                throw new ApiError(implode(', ', $json['errors']), $code, $result);
-            } else {
-                // return response headers if they were asked for
-                if (count($response_headers) !== 0) {
-                    $res = [
-                        'code' => $code,
-                        'data' => $json
-                    ];
-                    foreach ($return_headers as $key => $value) {
-                        // most headers has char '-' but it is forbidden in PHP names replace it with '_'
-                        $res[strtolower(str_replace('-', '_', $value))] =
-                            (isset($response_headers[$value]) ? $response_headers[$value] : null);
-                    }
-                    return $res;
-                }
-                return $json;
-            }
-        } elseif (isset($code) && (!isset($result) || !$result)) {
-            throw new ApiError('', $code, $result);
-        } else {
-            if (isset($json['messages'])) {
-                $msg = '';
-                foreach ($json['messages'] as $key => $value) {
-                    if ($msg !== '') {
-                        $msg .= PHP_EOL;
-                    }
-                    $msg .= $key . ': ' . implode(', ', $value);
-                }
-                throw new ApiError($msg, $code, $result);
-            } elseif (isset($json['errors'])) {
-                $msg = '';
-                foreach ($json['errors'] as $key => $value) {
-                    if ($msg !== '') {
-                        $msg .= PHP_EOL;
-                    }
-                    $msg .= $value;
-                }
-                throw new ApiError($msg, $code, $result);
-            } else {
-                throw new ApiError($result, $code, $result);
-            }
-        }
-    }
-
-    /**
-     * @param $object: JSON object
-     */
-    public static function object2array($object)
-    {
-        return @json_decode(@json_encode($object), 1);
-    }
-
-    /**
-     * Prints on the screen main keys and values of the array.
-     *
-     * @param $results: object to be printed on the screen
-     * @param $deepPrinting: if true, object will be printed recursively
-     */
-    public static function simplePrint($results, $deepPrinting = null)
-    {
-        if (isset($results)) {
-            if (is_array($results)) {
-                foreach ($results as $key => $result) {
-                    if (is_array($result)) {
-                        foreach ($result as $key1 => $result1) {
-                            if (is_array($result1)) {
-                                if ($deepPrinting) {
-                                    echo "<br>$key1 ------><br>";
-                                    self::simplePrint($result1, true);
-                                    echo '------<br>';
-                                } else {
-                                    echo $key1.' --> '.'Array() <br>';
-                                }
-                            } else {
-                                if (is_object($result1)) {
-                                    if ($deepPrinting) {
-                                        echo "<br>$key1 ------><br>";
-                                        $oarray = (array) $result1;
-                                        self::simplePrint($oarray, true);
-                                        echo '------<br>';
-                                    } else {
-                                        echo $key1.' --> '.'Object <br>';
-                                    }
-                                } else {
-                                    if (!is_null($result1)) {
-                                        echo $key1.' --> '.$result1.'<br>';
-                                    }
-                                }
-                            }
-                        }
-                    } else {
-                        if (is_object($result)) {
-                            if ($deepPrinting) {
-                                echo "<br>$key ------><br>";
-                                $oarray = (array) $result;
-                                self::simplePrint($oarray, true);
-                                echo '------<br>';
-                            } else {
-                                echo $key.' --> '.'Object <br>';
-                            }
-                        } else {
-                            if (!is_null($result)) {
-                                echo $key.' --> '.$result.'<br>';
-                            }
-                        }
-                    }
-                    //echo "<br>";
-                }
-            }
-        }
-    }
-
-    /**
-     * Generates query or body parameters.
-     *
-     * @param $allFields: all known fields could be used for parameters generation
-     * @param $params: input parameters (array or object)
-     */
-    public static function generateRequestParameters($allFields, $params)
-    {
-        $generatedParams = [];
-
-        if (is_array($params)) {
-            foreach ($allFields as $field) {
-                if (isset($params[$field])) {
-                    $generatedParams[$field] = $params[$field];
-                }
-            }
-        } elseif (is_object($params)) {
-            foreach ($allFields as $field) {
-                if (isset($params->{$field})) {
-                    $generatedParams[$field] = $params->{$field};
-                }
-            }
-        }
-
-        return $generatedParams;
-    }
-
-    /**
-     * Returns an array of the object properties.
-     *
-     * @param $object: An object
-     * @param $exclude: array of the object parameters to be excluded from the returned array
-     */
-    public static function getObjectProperties($object, $exclude)
-    {
-        $objectParameters = [];
-
-        foreach (get_object_vars($object) as $key => $value) {
-            if (property_exists($object, $key)) {
-                if (!is_numeric(array_search($key, $exclude))) {
-                    array_push($objectParameters, $key);
-                }
-            }
-        }
-
-        return $objectParameters;
-    }
-
-    /**
-     * Returns url path generated from the array of the fields and parameters.
-     *
-     * @param $allFields; array of the paossible fields (parameter names)
-     * @param $params: input parameters (array or object)
-     */
-    public static function generateUrlPath($allFields, $params)
-    {
-        $generatedPath = '';
-
-        if (is_array($params)) {
-            foreach ($allFields as $field) {
-                if (isset($params[$field])) {
-                    $generatedPath .= $params[$field].'/';
-                }
-            }
-        } elseif (is_object($params)) {
-            foreach ($allFields as $field) {
-                if (isset($params->{$field})) {
-                    $generatedPath .= $params->{$field}.'/';
-                }
-            }
-        }
-
-        return $generatedPath;
-    }
-
-    public static function getFileRealPath($fileName)
-    {
-        $rpath = function_exists('curl_file_create') ? curl_file_create(realpath($fileName)) : '@'.realpath($fileName);
-
-        return $rpath;
-    }
+	public static $apiKey;
+	public static $baseUrl = Endpoint::BASE_URL;
+
+	public static function setApiKey($apiKey)
+	{
+		self::$apiKey = $apiKey;
+	}
+
+	public static function getApiKey()
+	{
+		return self::$apiKey;
+	}
+
+	public static function setBaseUrl($baseUrl)
+	{
+		self::$baseUrl = $baseUrl;
+	}
+
+	public static function getBaseUrl()
+	{
+		return self::$baseUrl;
+	}
+
+	/**
+	 * Make request with CURL
+	 *
+	 * @since 1.2.3 changed error handling
+	 * @since 1.2.8 added $options['return_headers']
+	 *
+	 * @param array  $options
+	 *   string url                        - HTTP URL.
+	 *   string method                     - HTTP method.
+	 *   string api_key                    - API key to access to route4me server.
+	 *   array  query                      - Array of query parameters.
+	 *   array  body                       - Array of body parameters.
+	 *   string HTTPHEADER                 - Content type of body e.g.
+	 *                                       'Content-Type: application/json'
+	 *                                       'Content-Type: multipart/form-data'
+	 *   array  HTTPHEADERS                - Array of headers.
+	 *   string FILE                       - Path to uploading file.
+	 *   array  return_headers             - Array of response headers to return as a result.
+	 * @throws Exception\ApiError
+	 */
+	public static function makeRequst($options)
+	{
+		$method = isset($options['method']) ? $options['method'] : 'GET';
+		$query = isset($options['query'])
+			? array_filter($options['query'], function ($x) {
+				return !is_null($x);
+			}) : [];
+
+		$body = isset($options['body']) ? $options['body'] : null;
+		$file = isset($options['FILE']) ? $options['FILE'] : null;
+		$headers = [
+			'User-Agent: Route4Me php-sdk',
+		];
+
+		$return_headers = (isset($options['return_headers']) ? $options['return_headers'] : null);
+
+		if (isset($options['HTTPHEADER'])) {
+			$headers[] = $options['HTTPHEADER'];
+		}
+
+		if (isset($options['HTTPHEADERS'])) {
+			foreach ($options['HTTPHEADERS'] as $header) {
+				$headers[] = $header;
+			}
+		}
+
+		$ch = curl_init();
+
+		$url = isset($options['url'])
+			? $options['url'] . '?' . http_build_query(array_merge(
+				$query,
+				['api_key' => self::getApiKey()]
+			)) : '';
+
+		$baseUrl = self::getBaseUrl();
+
+		$curlOpts = [
+			CURLOPT_URL             => $baseUrl.$url,
+			CURLOPT_RETURNTRANSFER  => true,
+			CURLOPT_TIMEOUT         => 120,
+			CURLOPT_FOLLOWLOCATION  => true,
+			CURLOPT_SSL_VERIFYHOST  => false,
+			CURLOPT_SSL_VERIFYPEER  => false,
+			CURLOPT_HTTPHEADER      => $headers,
+		];
+
+		curl_setopt_array($ch, $curlOpts);
+
+		// read response headers if need
+		$response_headers = [];
+		if ($return_headers) {
+			curl_setopt($ch, CURLOPT_HEADERFUNCTION, function ($curl, $header) use (&$response_headers) {
+				$len = strlen($header);
+				$header = explode(':', $header, 2);
+				if (count($header) >= 2) {
+					$response_headers[strtolower(trim($header[0]))] = trim($header[1]);
+				}
+				return $len;
+			});
+		}
+
+		if (null != $file) {
+			$cfile = new \CURLFile($file, '', '');
+			$body['strFilename']=$cfile;
+			curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
+			curl_setopt($ch, CURLOPT_POST, true);
+			curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
+		} else {
+			switch ($method) {
+				case 'DELETE':
+					curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
+					break;
+				case 'DELETEARRAY':
+					curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
+					curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($query));
+					break;
+				case 'PUT':
+					curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
+					break;
+				case 'POST':
+					if (isset($body)) {
+						$bodyData = json_encode($body);
+						if (isset($options['HTTPHEADER'])) {
+							if (strpos($options['HTTPHEADER'], 'multipart/form-data') > 0) {
+								$bodyData = $body;
+							}
+						}
+						curl_setopt($ch, CURLOPT_POSTFIELDS, $bodyData);
+					}
+					break;
+				case 'ADD':
+					curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($query));
+					break;
+				case 'PATCH':
+					if (isset($body)) {
+						$bodyData = json_encode($body);
+						if (isset($options['HTTPHEADER'])) {
+							if (strpos($options['HTTPHEADER'], 'multipart/form-data') > 0) {
+								$bodyData = $body;
+							}
+						}
+						curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');
+						curl_setopt($ch, CURLOPT_POSTFIELDS, $bodyData);
+					}
+					break;
+			}
+
+			if (is_numeric(array_search($method, ['DELETE', 'PUT']))) {
+				if (isset($body)) {
+					curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
+				}
+			}
+		}
+
+		$result = curl_exec($ch);
+		$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+		curl_close($ch);
+
+		$json = null;
+		if (strpos($result, '<?xml') > -1) {
+			$xml = simplexml_load_string($result);
+			$json = self::object2array($xml);
+		} else {
+			$json = json_decode($result, true);
+		}
+		if (200 == $code || 201 == $code || 202 == $code) {
+			if (isset($json['errors'])) {
+				throw new ApiError(implode(', ', $json['errors']), $code, $result);
+			} else {
+				// return response headers if they were asked for
+				if (count($response_headers) !== 0) {
+					$res = [
+						'code' => $code,
+						'data' => $json
+					];
+					foreach ($return_headers as $key => $value) {
+						// most headers has char '-' but it is forbidden in PHP names replace it with '_'
+						$res[strtolower(str_replace('-', '_', $value))] =
+							(isset($response_headers[$value]) ? $response_headers[$value] : null);
+					}
+					return $res;
+				}
+				return $json;
+			}
+		} elseif (isset($code) && (!isset($result) || !$result)) {
+			throw new ApiError('', $code, $result);
+		} else {
+			if (isset($json['messages'])) {
+				$msg = '';
+				foreach ($json['messages'] as $key => $value) {
+					if ($msg !== '') {
+						$msg .= PHP_EOL;
+					}
+					$msg .= $key . ': ' . implode(', ', $value);
+				}
+				throw new ApiError($msg, $code, $result);
+			} elseif (isset($json['errors'])) {
+				$msg = '';
+				foreach ($json['errors'] as $key => $value) {
+					if ($msg !== '') {
+						$msg .= PHP_EOL;
+					}
+					$msg .= $value;
+				}
+				throw new ApiError($msg, $code, $result);
+			} else {
+				throw new ApiError($result, $code, $result);
+			}
+		}
+	}
+
+	/**
+	 * @param $object: JSON object
+	 */
+	public static function object2array($object)
+	{
+		return @json_decode(@json_encode($object), 1);
+	}
+
+	/**
+	 * Prints on the screen main keys and values of the array.
+	 *
+	 * @param $results: object to be printed on the screen
+	 * @param $deepPrinting: if true, object will be printed recursively
+	 */
+	public static function simplePrint($results, $deepPrinting = null)
+	{
+		if (isset($results)) {
+			if (is_array($results)) {
+				foreach ($results as $key => $result) {
+					if (is_array($result)) {
+						foreach ($result as $key1 => $result1) {
+							if (is_array($result1)) {
+								if ($deepPrinting) {
+									echo "<br>$key1 ------><br>";
+									self::simplePrint($result1, true);
+									echo '------<br>';
+								} else {
+									echo $key1.' --> '.'Array() <br>';
+								}
+							} else {
+								if (is_object($result1)) {
+									if ($deepPrinting) {
+										echo "<br>$key1 ------><br>";
+										$oarray = (array) $result1;
+										self::simplePrint($oarray, true);
+										echo '------<br>';
+									} else {
+										echo $key1.' --> '.'Object <br>';
+									}
+								} else {
+									if (!is_null($result1)) {
+										echo $key1.' --> '.$result1.'<br>';
+									}
+								}
+							}
+						}
+					} else {
+						if (is_object($result)) {
+							if ($deepPrinting) {
+								echo "<br>$key ------><br>";
+								$oarray = (array) $result;
+								self::simplePrint($oarray, true);
+								echo '------<br>';
+							} else {
+								echo $key.' --> '.'Object <br>';
+							}
+						} else {
+							if (!is_null($result)) {
+								echo $key.' --> '.$result.'<br>';
+							}
+						}
+					}
+					//echo "<br>";
+				}
+			}
+		}
+	}
+
+	/**
+	 * Generates query or body parameters.
+	 *
+	 * @param $allFields: all known fields could be used for parameters generation
+	 * @param $params: input parameters (array or object)
+	 */
+	public static function generateRequestParameters($allFields, $params)
+	{
+		$generatedParams = [];
+
+		if (is_array($params)) {
+			foreach ($allFields as $field) {
+				if (isset($params[$field])) {
+					$generatedParams[$field] = $params[$field];
+				}
+			}
+		} elseif (is_object($params)) {
+			foreach ($allFields as $field) {
+				if (isset($params->{$field})) {
+					$generatedParams[$field] = $params->{$field};
+				}
+			}
+		}
+
+		return $generatedParams;
+	}
+
+	/**
+	 * Returns an array of the object properties.
+	 *
+	 * @param $object: An object
+	 * @param $exclude: array of the object parameters to be excluded from the returned array
+	 */
+	public static function getObjectProperties($object, $exclude)
+	{
+		$objectParameters = [];
+
+		foreach (get_object_vars($object) as $key => $value) {
+			if (property_exists($object, $key)) {
+				if (!is_numeric(array_search($key, $exclude))) {
+					array_push($objectParameters, $key);
+				}
+			}
+		}
+
+		return $objectParameters;
+	}
+
+	/**
+	 * Returns url path generated from the array of the fields and parameters.
+	 *
+	 * @param $allFields; array of the paossible fields (parameter names)
+	 * @param $params: input parameters (array or object)
+	 */
+	public static function generateUrlPath($allFields, $params)
+	{
+		$generatedPath = '';
+
+		if (is_array($params)) {
+			foreach ($allFields as $field) {
+				if (isset($params[$field])) {
+					$generatedPath .= $params[$field].'/';
+				}
+			}
+		} elseif (is_object($params)) {
+			foreach ($allFields as $field) {
+				if (isset($params->{$field})) {
+					$generatedPath .= $params->{$field}.'/';
+				}
+			}
+		}
+
+		return $generatedPath;
+	}
+
+	public static function getFileRealPath($fileName)
+	{
+		$rpath = function_exists('curl_file_create') ? curl_file_create(realpath($fileName)) : '@'.realpath($fileName);
+
+		return $rpath;
+	}
 }