8 (800) 700 05-81

Отправка смс сообщений

24 мар 2015

Метод:

http://api.fastsms.pro/send.php

Пример запроса:

http://api.fastsms.pro/send.php?key=123&numbers=79998887754&message=Привет&sender=OnlineSmsRf

Обязательные параметры:

sender имя отправителя SMS. Максимальная длина значения – 16 символов для цифровых значений и 11, если Вы используете символы. Диапазон возможных значений a-z, A-Z, 0-9.
numbers номера абонентов, разделенные запятой. Максимальное количество номеров в одном обращении - 15000.
message Ваше сообщение в кодировке UTF-8, максимальная длина - 10 смс частей (660 символов на кириллице, 1520 латинскими буквами). Кодировка будет распознана автоматически. Размер одного сообщения составляет:
Транслит:
    - 160 символов
    - 152 символа, если длина сообщения превышает 160 символов
Другие языки:
    - 70 символов в кириллице или включающем символы не из ASCII
    - 66 символов, если длина сообщения превышает 70 символов

 Дополнительные параметры:

testing если вы хотите протестировать работу api, но не хотите совершать реальную отправку смс (и тратить свои средства), то поставьте значение этого параметра в 1, сообщение будет точно так же отображено в личном кабинете, но средства списаны не будут, хотя и будет указана стоимость сообщения по Вашему тарифу. Через некоторое время статус сообщения поменяется с "отправлено" на "не доставлено". При этом Вы сможете так же протестировать запрос статусов СМС (включая получение статусов на собственный URL)
ch_typ тип канала. 1 - прямой канал, 2 - непрямой канал
toWorld телефонный код страны, пример для России: 7. Этот параметр используется для преобразования номеров в формат данной страны
translit 1 - транслитерация русскоязычного сообщения латинскими буквами
unsubscribe 1, если нужно вставить сообщение со ссылкой "отписаться от рассылки"
smoothSend 1 - "плавная" отправка
sm_col при плавной отправке - количество смс сообщений за раз, например 10
sm_int при плавной отправке - интервал времени между отправками, в минутах, пример: 5
lateSend 1 - "запланированная" отправка
date при запланированной отправке - дата отправки в формате пользователя (формат определяется в настройках сайта, пример: если формат определен как дд.мм.гггг, тогда дата будет выглядеть как 24.03.2015);
при регулярной отправке - дата начиная с которой включается регулярная отправка;
time при запланированной отправке - время дня когда будет отправлено сообщение;
при регулярной отправки - время дня в которое сообщение будет регулярно отправляться;
параметр может быть в формате целого числа - количество секунд от начала суток или в формате чч:мм (пр. 13:30). Альтернативно время может быть указано через параметры hour и mins
hour часы - альтернативный параметр для указания времени, пример - 13
mins минуты - альтернативный параметр для указания времени, пример - 30
local 1 - отправлять по времени контакта-получателя. 0 или отсутствие параметра - отправлять по вашему времени, учитывая часовой пояс указанный в настройках сайта.
dlr 1 - запрос отчета о доставке на ваш указанный в настройках сайта URL. Т.е. любые изменения статуса будут приходить на ваш URL (который вы можете указывать в разделе "Настройки API")
DUP_CONT 1 - исключение номеров-дубликатов, которые уже содержатся в ваших контактах, из рассылки
dupsent 1 - исключение из рассылки номеров, которые уже были отправлены ранее, интервал этого фильтра задается параметром dupsent_radio
dupsent_radio фильтр для определения интервала времени, в пределах которого будут исключены номера-дубликаты; 8 - всё время, 16 - отправленные сегодня, 32 - доставленные сегодня

 

Ответ от сервера

В результате сервер возвратит число - идентификатор рассылки, который вы можете использовать в дальнейшем для проверки статуса сообщений. В случае плавной отправки рассылка разбивается на несколько рассылок, поэтому  возвращается несколько идентификаторов через запятую - на каждую рассылку по одному.

 

Пример отправки SMS на PHP:

 

function SendSMS ($to, $text) {
	$vars = Array (
		'username'	=> 'username',
		'password'	=> md5 ('pwd'),
		'sender'	=> 'Sender',
		'ch_typ'	=> 1,
		'numbers'	=> $to,
		'message'	=> $text
	);

	$url = 'http://api.fastsms.pro/send.php';

	$curl = curl_init();
	curl_setopt ($curl, CURLOPT_URL, $url);
	curl_setopt ($curl, CURLOPT_TIMEOUT, 3);
	curl_setopt ($curl, CURLOPT_HEADER, 0);
	curl_setopt ($curl, CURLOPT_POST, 1);
	curl_setopt ($curl, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt ($curl, CURLOPT_POSTFIELDS, http_build_query ($vars));
	$result = curl_exec ($curl);
	curl_close ($curl);

	if (is_numeric ($result)) {
		$reference = $result;
		echo 'The message is successfully sent. The reference is '.$reference;
	} else {
		@list ($err, $errcode) = explode (":", $result, 2);
		echo 'ERROR '.$errcode.'! message not sent.';
	}
}

SendSMS ('YOURNUMBER, 'YOURTEXT);

Комментарии

Пока никто не оставлял комментариев