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

Метод createSmsMessage

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

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

{"result":{"message_id":356238}}

{"error":"invalid sender","code":"invalid_arg","result":""}

{"error":"invalid list_id","code":"invalid_arg","result":""}
      

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

• createEmailMessage
• createCampaign
• getCampaignDeliveryStats

Примеры формирования URL-запроса

http://api.unisender.com/ru/api/createSmsMessage?format=json&api_key=KEY
&sender=UniSender&body=Test+SMS-message+from+UniSender&list_id=778899

— подготовить новое SMS-сообщение Test SMS-message на все номера списка 778899 с указанием обратного номера UniSender.

Примеры на PHP

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

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

// Параметры создаваемого SMS-сообщения
// Если скрипт в кодировке UTF-8, удалите вызов iconv
$sms_from = "UniSender";
$sms_to = "354168";
$sms_text = iconv('cp1251', 'utf-8', "Привет, {{Name}}, получи нашу SMS-рассылку");

// Создаём POST-запрос
$POST = array (
  'api_key' => $api_key,
  'sender' => $sms_from,
  'list_id' => $sms_to,
  'body' => $sms_text,
);

// Устанавливаем соединение
$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/createSmsMessage?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 {
    // Новое SMS-сообщение успешно создано
    echo "SMS-message is created";

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

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

// Параметры создаваемого SMS-сообщения
// Если скрипт в кодировке UTF-8, удалите вызов iconv
$sms_from = "UniSender";
$sms_to = "354168";
$sms_text = urlencode(iconv('cp1251', 'utf-8', "Привет, {{Name}}, получи SMS"));

// Создаём GET-запрос
$api_url = "http://api.unisender.com/ru/api/createSmsMessage?format=json".
           "&api_key=$api_key&sender=$sms_from&list_id=$sms_to&body=$sms_text";

// Делаем запрос на API-сервер
$result = file_get_contents($api_url);

if ($result) {
  // Раскодируем ответ API-сервера
  $jsonObj = json_decode($result);

  if(null===$jsonObj) {
    // Ошибка в полученном ответе
    echo "Invalid JSON";

  }
  elseif(!empty($jsonObj->error)) {
    // Ошибка создания SMS-сообщения
    echo "An error occured: " . $jsonObj->error . "(code: " . $jsonObj->code . ")";

  } else {
    // Новое SMS-сообщение успешно создано
    echo "SMS-message is created";

  }

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