OCStore
Prestashop
1С-Битрикс
WordPress WooCommerce
R-Keeper (UCS)
Приступая к работе с API подключением, нам потребуется информация, чтобы активировать ваш счет и доступ к протоколу HTTP.
Необходимые данные для создания подключения:
Получив эту информацию, для вас будет сформирован API- ключ, который может быть использован для верификации подключения.
Примечание — для каждой среды (если у вас их несколько), из которой вы хотите отправить SMS, например, среда разработки/ тестирования и среда продукции, понадобится отдельный API — счет и отдельный API- ключ.
Стандартная длина SMS составляет 160 символов из алфавита GSM
(http://en.wikipedia.org/wiki/GSM_03.38). Более длинные SMS можно отправлять по отдельным частям, которые в конце для получателя будут объединены в одно SMS, но каждая из этих частей будет показана в счете как отдельное SMS. Однако, отправляя несколько SMS-пакетов, каждая отдельная часть немного короче, чем одно SMS — одна часть может содержать до 153 символов, например, 160-символьное SMS может быть отправлено как SMS, состоящее из одной части, а 170-символьное SMS будет отправлено в двух пакетах – в первом 153 символа, во втором – 17.
Так как алфавит GSM содержит только небольшую часть всех возможных символов, то SMS можно отправить в Юникоде, где возможны все символы, доступные в кодировании UCS-2, но в этом случае длина SMS уменьшится — SMS в юникоде может быть до 70 SMS в длину, или, если отправляется SMS-пакет, то каждая часть SMS может содержать до 67 символов.
Примечание — в алфавите GSM целый ряд символов, которые могут занимать место двух символов, например, символ евро, квадратные скобки ([]) и др.
Теоретически возможно отправлять отдельные SMS-пакеты, состоящие даже из 255 частей, но из-за разной совместимости операторов, SMS-каналов и телефонных аппаратов максимально допустимая длина SMS-пакетов составляет 3 части SMS.
В зависимости от заключенного соглашения между вами и SMSTitan, для вашей учетной записи может быть предоставлена либо ежемесячная квота для отправки SMS (для договоров с последующей оплатой), либо лимит SMS (для договоров предоплаты) в зависимости от оплаченного объема. Величина ежемесячной квоты устанавливается по взаимному согласию и предусмотрена, в первую очередь, из соображений безопасности, чтобы в результате случайных (или намеренных) действий не отправлялось чрезмерное количество SMS-сообщений.
Адрес сервиса: http://traffic.smstitan.ru/API:0.9/
Все данные следует предоставлять в рамках запросов HTTP POST.
Для каждого запроса существуют обязательные параметры (названия case-sensitive):
Другие параметры зависят от конкретной команды.
Выдаваемые из команд данные сериализуются с JSON.
Если полученный запрос ошибочен, то в ответ выдается параметр Error с кодом ошибки.
Общие коды ошибок, относящиеся на все команды:
Желательно использовать SendBatch / AddBatchRecipients, кроме случаев, когда действительно необходимо отправить по одному отдельному SMS.
Описание команд:
SendBatch
Входящие параметры:
По содержанию автоматически определяется, либо следует отправлять в Юникоде и/или как отдельный SMS-пакет.
Выдаваемые в ответе параметры:
Возможные ошибки:
AddBatchRecipients
Входящие параметры:
79167156549, …]»
Выдаваемые в ответе параметры:
Если среди получателей какой-то номер повторяется несколько раз, то в параметре выдаваемых данных MSSID он отобразится только один раз с одним ID SMS, и отправлено будет только одно SMS.
Возможные ошибки:
Как значения MSSID:
В параметре Error:
SendOne
Входящие параметры:
По содержанию автоматически определяется, либо следует отправлять в Юникоде и/или в виде отдельных SMS-пакетов.
Выдаваемые в ответе параметры:
Возможные ошибки:
GetSenders
Входящие параметры: нет
Выдаваемые в ответе параметры:
Отчеты о доставке
На указанный клиентом адрес для отчетов присылается ссылка в виде HTTP POST с двумя параметрами:
В нормальных условиях отчетов Error и Other не должно быть вообще.