• Главная
• Ресурсы
• Документация
• API
• activateContacts

Метод activateContacts

Метод активации контактов. Прежде, чем посылать сообщение какому-либо контакту, он должен в статусе «активен». Пока метод поддерживает только активацию email-адресов. Они могут быть активированы либо не активированы, в зависимости от размера списка, наличия в нем «подозрительных» адресов и репутации пользователя. Если адреса не активируются автоматически, то администрации сервиса направляется запрос на ручную активацию. Активирован может быть только полный список адресов, частичной активации списка произойти не может.

При запросе активации обязательно указываются либо коды списков для активации, либо перечень контактов, которые надо активировать.

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

contact_type=email

contacts=a@example.org,b@example.org,c@example.org

contacts[]=a@example.org&contacts[]=b@example.org
&contacts[]=c@example.org

list_ids=7762787,12345
list_ids[]=7762787&list_ids[]=12345

{"result":{"activated":1068}}

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

• getLists
• importContacts
• exportField

Примеры на PHP

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

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

// Параметры для запроса активации
$contact_type = "email";

// Коды списков для активации
$list_ids = "354168";

// Список контактов для активации. В данном примере будут 
// проигнорированы, т.к. указан и list_ids
// $contacts = "just_addded_email@inbox.ru";

// Создаём POST-запрос
$POST = array (
  'api_key' => $api_key,
  'contact_type' => $contact_type,
  'contacts' => $contacts,
  'list_ids' => $list_ids
);

// Устанавливаем соединение
$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/activateContacts?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 "Number of activated contacts: " . $jsonObj->result->activated;

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

// Ваш ключ доступа к API (из Личного Кабинета)
$api_key = "xxxxxxxxxxxxxxxx";

// Параметры для запроса активации
$contact_type = "email";

// Коды списков для активации, если не задано, то запрос на активацию всех
$list_ids = "354168";

// Список контактов для активации, если не указано, то считается, что все
// $contacts = "just_addded_email@inbox.ru";

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

// Делаем запрос на 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 "Number of activated contacts: " . $jsonObj->result->activated;
  }

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