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

Метод createEmailMessage

Метод для создания e-mail сообщения без отправки. Непосредственно отправка осуществляется с помощью другого метода — createCampaign.

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

attachments[quotes.txt]=text%20file%content

{"result":{"message_id":357088}}

{"error":"unchecked sender email","code":"invalid_arg","result":""}
      

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

• createSmsMessage
• createCampaign
• getCampaignDeliveryStats

Примеры на PHP

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

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

// Параметры создаваемого email-сообщения
// Если скрипт в кодировке UTF-8, удалите вызовы iconv
$email_from_name = iconv('cp1251', 'utf-8', "Пал Палыч");
$email_from_email = "pal.palych@yandex.ru";
$email_subject = iconv('cp1251', 'utf-8', "Тема нового e-mail сообщения");
$email_to = "354168";  // код списка, по которому делать рассылку
$email_text = urlencode(iconv('cp1251', 'utf-8', "<p>Привет, {{Name}}, ".
              "<font color='red' size='+2'>вот</font> <b>".
              "наша</b> рассылка</p>"));

// Прикрепим простой текстовый файл:
$email_attach_file_name = iconv('cp1251', 'utf-8', "текстовый файл.txt");
$email_attach_file_content = iconv('cp1251', 'utf-8', "Содержимое файла");

// Создаём POST-запрос
$POST = array (
  'api_key' => $api_key,
  'sender_name' => $email_from_name,
  'sender_email' => $email_from_email,
  'subject' => $email_subject,
  'list_id' => $email_to,
  'body' => $email_text,
  'attachments[' . $email_attach_file_name . ']' => $email_attach_file_content
);

// Устанавливаем соединение
$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/createEmailMessage?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. Message ID is " . $jsonObj->result->message_id;

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

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

// Параметры создаваемого email-сообщения
// Если скрипт в кодировке UTF-8, удалите вызовы iconv
$email_from_name = urlencode(iconv('cp1251', 'utf-8', "Пал Палыч"));
$email_from_email = urlencode("pal.palych@yandex.ru");
$email_subject = urlencode(iconv('cp1251', 'utf-8', "Тема нового e-mail сообщения"));
$email_to = "354168";   // код списка, по которому делать рассылку
$email_text = urlencode(iconv('cp1251', 'utf-8', "<p>Привет, {{Name}}, ".
              "<font color='red' size='+2'>вот</font> <b>".
              "наша</b> рассылка</p>"));

// Прикрепим простой текстовый файл:
$email_attach_file_name = urlencode(iconv('cp1251', 'utf-8', "текстовый файл.txt"));
$email_attach_file_content = urlencode(iconv('cp1251', 'utf-8', "Содержимое файла"));

// Создаём GET-запрос
$api_url = "http://api.unisender.com/ru/api/createEmailMessage?format=json".
           "&api_key=$api_key&sender_name=$email_from_name".
           "&sender_email=$email_from_email".
           "&subject=$email_subject&list_id=$email_to&body=$email_text".
           "&attachments[$email_attach_file_name]=$email_attach_file_content";

// Делаем запрос на 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. Message ID is " . $jsonObj->result->message_id;
  }

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