XML-протокол

Данный протокол основан на передаче POST-запросом сформированной определенным образом XML (вместо привычных var1=value1&var2=value2) на наш сервер.

К примеру, на PHP такой запрос можно выполнить подобным образом:

$xml = "<?xml version='1.0' encoding='UTF-8'?>
	<data>
		<login>LOGIN</login>
		<password>PASSWORD</password>
		<action>send</action>
		<text>TEXT</text>
		<to number='89010003333'></to>
	</data>";
	
$address = "http://lcab.sms-sending.ru/API/XML/send.php";
$ch = curl_init($address);
curl_setopt($ch, CURLOPT_URL, $address);
curl_setopt($ch, CURLOPT_FAILONERROR, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $xml);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
$result = curl_exec($ch);
echo $result;
curl_close($ch);

А вот так можно отправлять запросы, используя C# в качестве языка программирования:

/*
	action = send|balance|report|cancel
	xml - строка, содержащая сформированную должным образом XML
*/
public String request(string action, string xml)
{
	WebResponse result = null;
	WebRequest req = null;
	Stream newStream = null;
	Stream ReceiveStream = null;
	StreamReader sr = null;
	string strOut = "";
	try
	{
		// Url запрашиваемого методом POST скрипта
		req = WebRequest.Create("http://lcab.sms-sending.ru/API/XML/" + action + ".php");
		req.Method = "POST";
		req.Timeout = 120000;
		req.ContentType = "application/x-www-form-urlencoded";
		byte[] SomeBytes = null;
		SomeBytes = UTF8Encoding.UTF8.GetBytes(xml);
		req.ContentLength = SomeBytes.Length;
		newStream = req.GetRequestStream();
		newStream.Write(SomeBytes, 0, SomeBytes.Length);
		newStream.Close();
		// считываем результат работы
		result = req.GetResponse();
		ReceiveStream = result.GetResponseStream();
		Encoding encode = Encoding.UTF8;
		sr = new StreamReader(ReceiveStream, encode);
		Char[] read = new Char[256];
		int count = sr.Read(read, 0, 256);
		while (count > 0)
		{
			String str = new String(read, 0, count);
			strOut += str;
			count = sr.Read(read, 0, 256);
		}
	}
	catch (Exception ex)
	{
		//MessageBox.Show("Ошибка: " + ex.Message);
	}
	finally
	{
		if (newStream != null)
			newStream.Close();
		if (ReceiveStream != null)
			ReceiveStream.Close();
		if (sr != null)
			sr.Close();
		if (result != null)
			result.Close();
	}
	return strOut;
}

Как осуществлять подобные POST-запросы при помощи используемого вами языка программирования, нужно поискать самостоятельно, в руководствах или учебниках.

Для отправки СМС, необходимо передать методом POST на адрес http://lcab.sms-sending.ru/API/XML/send.php следующую XML:

<?xml version='1.0' encoding='UTF-8'?>
	<data>
		<login>LOGIN</login>
		<password>PASSWORD</password>
		<action>ACTION</action>
		<text>TEXT</text>
		<to number='NUMBER'></to>
	</data>

<?xml version='1.0' encoding='UTF-8'?>
	<data>
		<code>CODE</code>
		<descr>DESCR</descr>
		<smsid>SMSID</smsid>
		<datetime>DATETIME</datetime>
		<action>ACTION</action>
		<allRecivers>ALL_RECIEVERS</allRecivers>
		<colSendAbonent>COL_SEND_ABONENT</colSendAbonent>
		<colNonSendAbonent> COL_NON_SEND_ABONENT </colNonSendAbonent>
		<priceOfSending>PRICE_OF_SENDING</priceOfSending>
		<colsmsOfSending>COL_SMS_OF_SENDING</colsmsOfSending>
		<price>PRICE</price>
	</data>

Задача 1. Требуется отправить следующий текст: «Добрый день, приглашаем Вас в наш салон», с подписью «Magazin» на 3 номера: +79019011234, +79029021234, +79039031234. Отправка должна произойти немедленно.

Решение:

На адрес http://lcab.sms-sending.ru/API/XML/send.php необходимо методом POST отправить следующую XML:

<?xml version='1.0' encoding='UTF-8'?>
	<data>
		<login>test</login>
		<password>123456</password>
		<action>send</action>
		<text>Добрый день, приглашаем Вас в наш салон</text>
		<source>Magazin</source>
		<to number='+79019011234'></to>
		<to number='7-902-902-12 34'></to>
		<to number='89039031234'></to>
	</data>

Обратите внимание, что поле номер может быть в любом формате, наша система сама приведет его в надлежащий вид.

Задача 2. Требуется отправить следующий текст: «Добрый день, приглашаем Вас в наш салон», с подписью «Magazin» на 3 номера: +79019011234, +79029021234, +79039031234. Отправка должна произойти 1 мая 2010 года в 12:00:00 (время Ваше местное – рассчитывается из информации, указанной при регистрации – Ваш город). На номер +79029021234 необходимо отправить уникальный текст: «Добрый день, приглашаем Вас в наш салон. Скидка по Вашей дисконтной карте – 5%»

Решение:

На адрес http://lcab.sms-sending.ru/API/XML/send.php необходимо методом POST отправить следующую XML:

<?xml version='1.0' encoding='UTF-8'?>
	<data>
		<login>test</login>
		<password>123456</password>
		<action>send</action>
		<text>Добрый день, приглашаем Вас в наш салон</text>
		<source>Magazin</source>
		<datetime>2010-05-01 12:00:00</datetime>
		<to number='+79019011234'></to>
		<to number='7-902-902-12 34'> Добрый день, приглашаем Вас в наш салон. Скидка по Вашей дисконтной карте – 5%</to>
		<to number='89039031234'></to>
	</data>

Обратите внимание, на формат даты/времени: указывать необходимо в формате MySQL.

Задача 3. Требуется отправить следующий текст: «Добрый день, приглашаем Вас в наш салон», с подписью «Magazin» на 3 номера: +79019011234, +79029021234, +79039031234. СМС необходимо отправить 1 февраля 2010 в 12:00:00 и повторить на те же номера с тем же текстом в 18:00:00. Отчет о доставленных СМС должен быть сгруппирован в один (для этих целей и существует параметр SMSID). По сути, SMSID – идентификатор рассылки, чтобы получить более удобный отчет. Если Вы будете отправлять 1000 СМС по одной, каждый раз отправляя POST запрос, то у Вас будет 1000 отчетов о доставке, что не совсем удобно в обработке.

Решение:

На адрес http://lcab.sms-sending.ru/API/XML/send.php необходимо методом POST отправить следующие XML (по очереди):

<?xml version='1.0' encoding='UTF-8'?>
	<data>
		<login>test</login>
		<password>123456</password>
		<smsid>abcde123</smsid>
		<action>send</action>
		<datetime>2010-02-01 12:00:00</datetime>
		<text>Добрый день, приглашаем Вас в наш салон</text>
		<source>Magazin</source>
		<to number='+79019011234'></to>
		<to number='7-902-902-12 34'></to>
		<to number='89039031234'></to>
	</data>

<?xml version='1.0' encoding='UTF-8'?>
	<data>
		<login>test</login>
		<password>123456</password>
		<smsid>abcde123</smsid>
		<action>send</action>
		<datetime>2010-02-01 18:00:00</datetime>
		<text>Добрый день, приглашаем Вас в наш салон</text>
		<source>Magazin</source>
		<to number='+79019011234'></to>
		<to number='7-902-902-12 34'></to>
		<to number='89039031234'></to>
	</data>

Обратите внимание, чтобы сгруппировать 2 рассылки в 1, для более удобного отчета (в данном примере для решения задачи), мы использовали параметр smsid=abcde123.

Для отмены рассылки необходимо передать методом POST на адрес http://lcab.sms-sending.ru/API/XML/cancel.php следующую XML.

<?xml version='1.0' encoding='UTF-8'?>
	<data>
		<login>LOGIN</login>
		<password>PASSWORD</password>
		<smsid>SMSID</smsid>
	</data>

<?xml version='1.0' encoding='UTF-8'?>
	<data>
		<code>CODE</code>
		<descr>DESCR</descr>
		<cancelCol>CANCELCOL</ cancelCol >
	</data>

Важное примечание: вы можете отменить только те СМС, которые не ушли в сеть оператора!