Метод checkUserExists
Проверяет, зарегистрирован ли пользователь с заданым login или email. Предназначен для вызова только реселлерами.
Принцип использования
| Синтаксис и URL для вызова метода |
|---|
| checkUserExists (string login, string email) |
| http://api.unisender.com/ru/api/checkUserExists?format=json&key=KEY&login=LOGIN&email=EMAIL |
| Аргументы | |
|---|---|
| api_key * | Ключ доступа к API. |
| login | Проверяемый логин пользователя. |
|
Проверяемый email-адрес пользователя. ВНИМАНИЕ! Должен быть задан как минимум один из параметров - login или email. Если заданы оба, независимо проверяется существование пользователя с таким логином и с таким email-адресом. |
|
| Возвращаемое значение |
|---|
|
JSON-обект с двумя полями: «login_exists» и «email_exists», имеющим значение 1 если найден пользователь с таким логином или, соответственно, email-адресом. Если пользователь не найден, соответствующее поле принимает значение 0. Пример возвращаемого значения: {"result":{"login_exists":0, "email_exists":1}}
|
Примеры на PHP
Мы настоятельно рекомендуем использовать POST-запросы, так как это более безопасный метод передачи данных, нежели GET. Подробнее о методах соединения здесь.
Пример с использованием POST-запроса
// Ваш ключ доступа к API (из Личного Кабинета)
$api_key = "xxxxxxxxxxxxxxxx";
// Проверяем существование пользователя с логином "ivanov".
$field_login = "ivanov";
$field_email = "";
// Создаём POST-запрос
$POST = array (
'api_key' => $api_key,
'login' => $field_login,
'email' => $field_email
);
// Устанавливаем соединение
$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $POST);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_URL,
'http://api.unisender.com/ru/api/checkUserExists?format=json');
$result = curl_exec($ch);
if ($result) {
// Раскодируем ответ API-сервера
$jsonObj = json_decode($result);
if (null===$jsonObj) {
// Ошибка в полученном ответе
echo "Invalid JSON";
}
elseif (!empty($jsonObj->error)) {
// Ошибка в методе
echo "An error occured: " . $jsonObj->error . "(code: " . $jsonObj->code . ")";
}
else {
// Обрабатываем результат
echo ($jsonObj->result->login_exists || $jsonObj->result->email_exists) ?
"User exsists" : "User does not exist";
}
} else {
// Ошибка соединения с API-сервером
echo "API access error";
}
Пример с использованием GET-запроса
// Ваш ключ доступа к API (из Личного Кабинета)
$api_key = "xxxxxxxxxxxxxxxxxx";
// Проверяем существование пользователя
// с логином "ivanov" и адресом "ivanov@mail.ru".
$field_login = "ivanov";
$field_email = "ivanov@mail.ru";
// Создаём GET-запрос
$api_url = "http://api.unisender.com/ru/api/checkUserExists?format=json".
"&api_key=$api_key&login=$field_login&email=$field_email;
// Делаем запрос на API-сервер
$result = file_get_contents($api_url);
if ($result) {
// Раскодируем ответ API-сервера
$jsonObj = json_decode($result);
if (null===$jsonObj) {
// Ошибка в полученном ответе
echo "Invalid JSON";
}
elseif (!empty($jsonObj->error)) {
// Ошибка в методе
echo "An error occured: " . $jsonObj->error . "(code: " . $jsonObj->code . ")";
}
else {
// Обрабатываем результат
echo ($jsonObj->result->login_exists || $jsonObj->result->email_exists) ?
"User exsists" : "User does not exist";
}
} else {
// Ошибка соединения с API-сервером
echo "API access error";
}



