Отправка SMS-сообщенй

API Сервиса отправки SMS-сообщений организован в соответствии с принципами REST, что позволяет обмениваться HTTPS-запросами с URL-encoded кодировкой. HTTPS - это обычный HTTP, работающий через шифрованные транспортные механизмы SSL и TLS. Это позволяет обеспечить защиту от атак, основанных на прослушивании сетевого соединения (снифферских атак и атак типа man-in-the-middle), при условии использования шифрующих средств и подтвержденной надежности сертификата сервера.

Для авторизации используется ApiKey полученный в личном кабинете для соответствующей компании. Пример заголовка:

Точка подключения:

Отправка сообщения на один номер (POST)

Сервис инициирует отправку SMS-сообщения в соответствии со значениями параметров, передаваемых сервису в POST-запросе следующего формата:

Параметры запроса:

Параметр Тип данных Описание Обязательный
phone string Номер получателя Да
text string Текст сообщения Да
sender_name string Имя отправителя Да
local_time boolean Учут часового пояса получателя Нет

Пример овтета:

Параметры ответа:

Параметр Тип данных Описание Обязательный
id integer Идентификатор SMS-сообщения Да
campaign_id integer Идентификатор кампании Да
subscriber_id integer Идентификатор получателя Да
status string Статус SMS-сообщения Да
created_at string Дата создания сообщения Да

Отправка сообщения на несколько номеров (POST)

Сервис инициирует отправку SMS-сообщения на несколько номеров в соответствии со значениями параметров, передаваемых сервису в POST-запросе следующего формата:

Параметры запроса:

Параметр Тип данных Описание Обязательный
phones string Номера получателей Да
text string Текст сообщения Да
sender_name string Имя отправителя Да
local_time boolean Учут часового пояса получателя Нет

Получение списка SMS-сообщений (GET)

Возвращает список сообщений.

Параметры запроса:

Параметр Тип данных Описание Обязательный
page integer Номер страницы Нет
per_page integer Кол-во записей Нет

Запрос статуса SMS-сообщения (GET)

Сервис возвращает статус отправленного sms-сообщения в соответствии со значениями параметров, передаваемых сервису в GET-запросе следующего формата:

Параметры запроса:

Параметр Тип данных Описание Обязательный
id integer Идентификатор SMS-сообщения Да

Запрос статистики за период (GET)

Сервис возвращает входящие sms-сообщения за период в соответствии со значениями параметров, передаваемых сервису в GET-запросе следующего формата:

Параметры запроса:

Параметр Тип данных Описание Обязательный
start_date date Дата начала выборки. Формат dd.mm.yyyy Да
end_date date Дата конца выборки. Формат dd.mm.yyyy Да
page integer Номер страницы Нет
per_page integer Кол-во записей Нет

Пример овтета:

Параметры ответа:

Параметр Тип данных Описание Обязательный
campaign_id integer Идентификатор SMS-кампании Да
date string Дата Да
delivered_count integer Доставлено сообщений Да
undelivered_count integer Не доставлено сообщений Да

Получение списка SMS-компаний (GET)

Возвращает список рассылок.

Параметры запроса:

Параметр Тип данных Описание Обязательный
page integer Номер страницы Нет
per_page integer Кол-во записей Нет

Пример овтета:

Параметры ответа:

Параметр Тип данных Описание Обязательный
id integer Идентификатор кампании Да
name string Название кампании Да
company_id integer Идентификатор компании Да
subscriber_list_id integer Идентификатор листа подписчиков Да
started boolean Флаг статуса Да
started_at string Дата и время старта кампании Да
user_id integer Пользователь, создавший кампанию Да
run_status string Статус процесса кампании Да

Запрос статистики по компании за период (GET)

Сервис возвращает статистику по SMS-рассылке за период в соответствии со значениями параметров, передаваемых сервису в GET-запросе следующего формата:

Параметры запроса:

Параметр Тип данных Описание Обязательный
id integer Идентификатор SMS-кампании Да
start_date date Дата начала выборки. Формат dd.mm.yyyy Да
end_date date Дата конца выборки. Формат dd.mm.yyyy Да
page integer Номер страницы Нет
per_page integer Кол-во записей Нет

Пример овтета:

Параметры ответа:

Параметр Тип данных Описание Обязательный
campaign_id integer Идентификатор SMS-кампании Да
date string Дата Да
delivered_count integer Доставлено сообщений Да
undelivered_count integer Не доставлено сообщений Да