new method getEmail added into the Users class

Author: EvilFreelancer

README.API.md

@@ -211,6 +211,7 @@ all()                       // Список туристов
 get($id)                    // Получение данных по конкретному туристу
 search($params)             // Поиск туристов по заданным фильтрам
 getLabel($params)           // Получение списка меток
+getEmail($email)            // Поиск туриста по электронному адресу
 getPhone($phone)            // Поиск туриста по номеру телефона
 getUpdated($date_from, $date_to)  // Список обновленных туристов
 create($params)             // Добавление туриста

README.md

@@ -15,11 +15,14 @@ This library is ready for production usage, all source codes provided "as is".
 require_once __DIR__ . "/vendor/autoload.php";
 
 // Your personal API token
-define("UON_API_TOKEN", "[YOUR_API_TOKEN]");
+$token = "[YOUR_API_TOKEN]";
+define("UON_API_TOKEN", $token);
 
 $_users = new \UON\Users();
 $_requests = new \UON\Requests();
-$_misc = new \UON\Misc();
+
+// You also can create any class with your tocken as argument
+$_misc = new \UON\Misc($token);
 
 // Get a list of all users
 $users = $_users->all();

src/Users.php

@@ -70,6 +70,17 @@ public function getPhone($phone)
         return $this->doRequest('get', $endpoint);
     }
 
+    /**
+     * @link    https://api.u-on.ru/{key}/user/email.{_format}
+     * @param   string $email
+     * @return  array|false
+     */
+    public function getEmail($email)
+    {
+        $endpoint = '/user/email';
+        return $this->doRequest('post', $endpoint, ['email' => $email]);
+    }
+
     /**
      * Get all users. profiles which were updated in the specified date range
      *