E-mail маркетинг, сервис рассылки e-mail и SMS
(495) 540-4265 (800) 555-6696

Метод validateSender

Метод отправляет по адресу email письмо со ссылкой на подтверждение адреса в качестве обратного. После перехода по этой ссылке можно будет отправлять письма от имени этого email-адреса.

Данный метод работает только для аккаунтов, имеющих статус реселлера.

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

Синтаксис и URL для вызова метода
validateSender (string email [, string login])
http://api.unisender.com/ru/api/validateSender?format=json&api_key=KEY&email=EMAIL&login=LOGIN
Аргументы
api_key * Ключ доступа к API
email * E-mail адрес, который вы хотите подставлять в поле «От кого» рассылаемых писем. На этот адрес для проверки будет отправлено письмо с уникальной ссылкой подтверждения. После перехода по этой ссылке адрес будет считаться проверенным и его можно указывать в поле «От кого». Письмо в целях предотвращения злоупотреблений отправляется со стандартной темой и текстом, но можно выбирать язык письма, указывая нужный язык в URL метода.
login Логин пользователя, которому будет разрешно использовать обратный адрес. Реселлер может указать здесь логин «своего» пользователя. Если логин не указан, то адрес будет привязан к вызывающему метод пользователю.
Возвращаемое значение
Отсутствует.

Смотрите также

Примеры на PHP

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

Пример с использованием POST-запроса
// Ваш ключ доступа к API (из Личного Кабинета)
$api_key = "xxxxxxxxxxxxxx";

// Новый обратный адрес, который надо проверить
$email = "new_sender_email@yandex.ru";

// Аккаунт, кому будет принадлежать этот адрес (если пусто - ваш)
$login = "user_login";

// Создаём POST-запрос
$POST = array (
  'api_key' => $api_key,
  'email' => $email,
  'login' => $login

);

// Устанавливаем соединение
$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/validateSender?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 "Success";
  }
} else {
  // Ошибка соединения с API-сервером
  echo "API access error";
}


Пример с использованием GET-запроса
// Ваш ключ доступа к API (из Личного Кабинета)
$api_key = "xxxxxxxxxxxxxxx";

// Новый обратный адрес, который надо проверить
$email = "new_sender_email@yandex.ru";

// Аккаунт, кому будет принадлежать этот адрес  (если пусто - ваш)
$login = "user_login";

// Создаём GET-запрос
$api_url = "http://api.unisender.com/ru/api/validateSender?format=json".
           "&api_key=$api_key&email=$email&login=$login";

// Делаем запрос на 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 "Success";
  }

} else {
  // Ошибка соединения с API-сервером
  echo "API access error";
}