Базовым протоколом интеграции является HTTP API протокол.
Работа по такому протоколу осуществляется путем выполнения HTTP-запроса (метод GET и метод POST) с перечнем параметров сообщения и авторизации.
В результате выполнения такого запроса, происходит передача отдельного СМС-сообщения нашему серверу и далее на отправку.
Таким образом, для отправки 1000 СМС выполняется 1000 подобных HTTP-запросов.
Посредством HTTP API протокола можно выполнять все стандартные функции оправки, в том числе отправку по расписанию. Если сообщение содержит хотя бы 1 символ unicode нужно использовать поле unicode=1
Отправка сообщения (метод GET, POST):
http://sprintsms.com.ua/sendsms.php?user=xxx&password=yyy&mobile=380XXXXXXX&senderid=test&message=привет&unicode=1
http://sprintsms.com.ua/sendsms.php?user=xxx&password=yyy&mobile=380XXXXXXX,380XXXXXXX&senderid=test&message=привет&unicode=1
http://sprintsms.com.ua/sendsms.php?user=xxx&password=yyy&mobile=380XXXXXXX,380XXXXXXX&senderid=test&message=hello&schedule=yyyy:mm:dd:hh:mm:ss&unicode=1
В ответ на запрос сервер возвращает код ответа и уникальный идентификатор сообщения на основании которого далее можно определять статус доставки сообщения.
Ограничения метода GET: Для отправки сообщений содержащих пробелы, нужно предварительно кодировать строку функцией аналогичной PHP Urlencode или использовать дополнительные кавычки
Готовые примеры реализации отправки методами GET и POST на языке PHP можно скачать здесь
Определение статуса доставки сообщения:
Существует 2 способа определения статусов о доставке сообщения
Способ 1. Используя уникальный идентификатор (полученный при отправке) выполнить HTTP-запрос на наш сервер. Сервер вернет код соответствующий статусу доставки.
После выполнения запроса по API будет выдан один из следующих ответов:
OK:success - означает, что сообщение отправлено и получено подтверждение о доставке
OK:wait_dlr - означает, что сообщение отправляется или уже отправлено, но пока не получено подтверждение о доставке
OK:failed - означает ошибку отправки сообщения
Способ 2. По индивидуальному запросу для Вас настраивается автоматический возврат статусов доставки через HTTP Push. При поступлении информации о статусе доставки сообщения, наш сервер выполняет HTTP-запрос на сервер заказчика и передает ему статус доставки сообщения, а также уникальный идентификатор этого сообщения. Для организации такого уведомления, заказчик должен предоставить свою ссылку для передачи статусов через HTTP методами POST либо GET.
Интеграция с 1с
Интеграцию с 1С можно реализовать подключив стандартную Windows-библиотеку winhttp.dll , что позволит получить в системе 1С функциональность HTTP запросов GET и POST.