меню
Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages

Метод checkUserExists

Проверяет, зарегистрирован ли пользователь с заданым login или email. Предназначен для вызова только реселлерами.

Принцип использования

Синтаксис и URL для вызова метода
checkUserExists (string login, string email)
https://api.unisender.com/ru/api/checkUserExists?format=json&api_key=KEY&login=LOGIN&email=EMAIL
Аргументы
api_key * Ключ доступа к API.
login Проверяемый логин пользователя.
email Проверяемый email-адрес пользователя.

ВНИМАНИЕ! Должен быть задан как минимум один из параметров — login или email. Если заданы оба, независимо проверяется существование пользователя с таким логином и с таким email-адресом.
Возвращаемое значение
json-обект с двумя полями: «login_exists» и «email_exists», имеющим значение 1 если найден пользователь с таким логином или, соответственно, email-адресом. Если пользователь не найден, соответствующее поле принимает значение 0.

Пример возвращаемого значения:

{"result":{"login_exists":0, "email_exists":1}}

Примеры на PHP

Мы настоятельно рекомендуем использовать POST-запросы, так как это более безопасный метод передачи данных, нежели GET. Используйте SSL-соединение с UniSender. Подробнее о методах соединения здесь.

Пример с использованием 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,
            'https://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 = "https://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";
}