Отправка SMS сообщений на основе HTTP протокола

Руководство по взаимодействию с сервисом коротких сообщений (SMS) на основе HTTP (POST) протокола

В случае возникновения вопросов обращайтесь в службу технической поддержки по телефону 8­800­100­6003 Звонок по России бесплатный.
Наши специалисты могут помочь Вам связать Ваш сайт, интернет магазин или ваше программное обеспечение с нашим сервисом абсолютно бесплатно. 
Адрес сервиса: http://my2.sms-­ka.net/api/httppost.php
 
Параметры:
  • APIKey = Ваш логин из сервиса
  • APIPassword = Пароль
  • BatchId = ID смс
  • Message = Текст сообщения
  • MSISDN = Номер получателя в формате 79XXXXXXXXX
  • SenderID = Имя отправителя
  • Action = Команда

Запрос на отправку СМС сообщения:

Параметры:
  • APIKey = Ваш логин из сервиса
  • APIPassword = Пароль
  • Message = Текст сообщения
  • MSISDN = Номер телефона
  • SenderID = Имя отправителя
  • Type = Тип сообщения (0 - СМС, 10 - Viber)
 
Пример:
 
Ответ:
0|Message sent|ah1acugxz98a27t9z|Balance status|7463
 
Формат ответа сервиса:
Статус запроса | Тип запроса | ID сообщения | Баланс | Остаток баланса 
 

Запрос баланса:

Параметры:
  • APIKey = Ваш логин из сервиса
  • APIPassword = Пароль
  • Action=balance
 
Пример:
 
Ответ:
 0|Balance status|7464
 
Формат ответа сервиса:
Статус запроса | Тип запроса | Остаток баланса 
 

Запрос статуса доставки СМС:

Параметры:
  • APIKey = Ваш логин из сервиса
  • APIPassword = Пароль
  • BatchId = ID смс
  • Action=query
 
Пример: 
 
Ответ:
0|Status|4|DELIVRD
 
Формат ответа сервиса:
Статус запроса | Тип запроса | Код статуса | Расшифровка статуса
 
Возможные статусы:
3|ACCEPTD = Отправлено
4|DELIVRD = Доставлено
5|REJECTD = Отклонено
6|REJECTD = Отклонено
7|EXPIRED = Просрочено
8|DELETED = Удалено
 

Возможные ошибки:

­1|Authentication failed. Your API Key, Password combination is not valid or your account 
has been locked.
Неправильный логин и/или пароль
­3|Sent Error
Ошибка отправки
­4|Argument validation failed. One or more of your POST­Vars is invalid or missing.
Неправильный набор параметров
­5|Insufficient Credits. You do not have sufficient credits to send the message.
Недостаточно кредитов
­6|Invalid MSISDN. The mobile number is not valid or can not be reached via the API
Неправильный формат номера получателя
­7|Your SenderID is not valid.
Неверное имя отправителя, запрещенное имя отправителя.
 

Кодировки

Параметр: Encode задает входную кодировку.
По умолчанию сервис работает с кодировкой UTF-8, для задания кодировки CP1251, нужно добавить в строку запроса параметр &Encode=CP1251. 

Скачать описание в PDF

Протестируй наш СМС сервис БЕСПЛАТНО!

Полезная информация

Отправка SMS сообщений на основе HTTP протокола