• Главная
  • Тарифы
  • Подключение (API)
  • Вопросы (FAQ)
  • Новости
  • Договор
  • Контакты
  • Вход

    • API / HTTP/HTTPS протокол / Получение входящих сообщений

    API позволяет рассылать сообщения через ваши проекты и сервисы по протоколам HTTP/HTTPS, SMTP и SMPP. Готовые библиотеки на разных языках программирования подключаются к вашему проекту и помогают отправлять сообщения из любого места с помощью одной команды.


    HTTP/HTTPS SMTP SMPP SOAP SMS-команды Библиотеки и примеры кода

    ОТПРАВКА СООБЩЕНИЙ

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

    Комментарии в SMS-сообщениях

    Отправка на группу номеров

    Отправка HLR-запроса

    Отправка MMS-сообщения

    Отправка e-mail сообщения

    Отправка голосового сообщения (звонок)

    Отправка viber-сообщения

    Использование префиксов при отправке сообщений

    Управление шаблонами сообщений

    Виртуальная отправка (режим тестирования)

    УПРАВЛЕНИЕ РАССЫЛКАМИ

    СТАТУСЫ СООБЩЕНИЙ

    ПРОВЕРКА СОСТОЯНИЯ БАЛАНСА

    УПРАВЛЕНИЕ КОНТАКТАМИ

    УПРАВЛЕНИЕ ИМЕНАМИ ОТПРАВИТЕЛЕЙ (SENDER ID)

    ПОЛУЧЕНИЕ ДАННЫХ

    РАЗНОЕ

    Получение входящих сообщений

    Для получения списка входящих сообщений необходимо вызвать методом GET или POST адрес: http://billing.smstraf.ru/sys/get.php?get_answers=1&login=<login>&psw=<password>
    Описание параметров, передаваемых Серверу:

    ПараметрЗначение
    loginЛогин Клиента.
    pswПароль Клиента или MD5-хеш пароля в нижнем регистре.
    hourПериод в часах, за который необходимо запросить входящие сообщения. Максимальное количество часов - 168 (7 дней).
    after_idИдентификатор сообщения, начиная с которого необходимо вернуть входящие сообщения, за исключением самого after_id.

    В случае ошибки Сервер возвращает следующую строку:
    • ERROR = N (описание)

    • При fmt = 1:
      0,-N

    • При fmt = 2:
      <result>
      <error>описание</error>
      <error_code>N</error_code>
      </result>

    • При fmt = 3:
      {
      "error": "описание",
      "error_code": N
      }
    N – номер ошибки, может принимать следующие значения:

    ЗначениеОписание
    1Ошибка в параметрах.
    2Неверный логин или пароль.
    4IP-адрес временно заблокирован.
    9Попытка отправки более трех одинаковых запросов на получение списка входящих сообщений в течение минуты.

    В случае успешного запроса Сервер возвращает ответ в виде строки:
    • при fmt = 0:
      id = <id>, received = <received>, phone = <phone>, message = <message>, to_phone = <to_phone>, sent = <sent>
      ...

    • при fmt = 1:
      <id>,<received>,<phone>,<to_phone>,<sent>,<message>
      ...

    • при fmt = 2:
      <sms_answers>
      <sms>
      <id>id</id>
      <received>received</received>
      <phone>phone</phone>
      <message>message</message>
      <to_phone>to_phone</to_phone>
      <sent>sent</sent>
      </sms>
      ...
      </sms_answers>

    • при fmt = 3:
      [{
      "id": <id>,
      "received": "<received>",
      "phone": "<phone>",
      "message": "<message>",
      "to_phone": "<to_phone>",
      "sent": "<sent>"
      },
      ...]

    Где:
    <id> – идентификатор входящего сообщения, назначаемый Сервером автоматически.
    <received> – дата получения сообщения Сервером. Формат DD.MM.YYYY hh:mm:ss.
    <phone> – номер телефона абонента.
    <message> – входящее сообщение.
    <to_phone> – номер телефона получателя.
    <sent> – дата отправки сообщения. Формат DD.MM.YYYY hh:mm:ss.


    Примеры:

    Получение списка входящих сообщений за текущие сутки:

    http://billing.smstraf.ru/sys/get.php?get_answers=1&login=alex&psw=123
    Получение списка входящих сообщений за последние 48 часов:

    http://billing.smstraf.ru/sys/get.php?get_answers=1&login=alex&psw=123&hour=48
    Получение списка входящих сообщений с идентификаторами, большими id="1234567":

    http://billing.smstraf.ru/sys/get.php?get_answers=1&login=alex&psw=123&after_id=1234567

    Сервер не принимает более трех одинаковых запросов в течение минуты на получение списка входящих сообщений для снижения нагрузки и защиты от ошибок и зацикливаний в программе на стороне Клиента.




    =100% cellpadding=0>Изменяется принцип тарификации SMS-сообщений в сеть оператора МТС (Россия)20.01.2026С 1 февраля г. изменяется принцип тарификации SMS в сеть оператора связи МТС (Россия). Оператор вводит пакетную тарификацию и единую стоимость для авторизационных и сервисных типов сообщений. Меняется стоимость для транзакционных SMS, при этом принцип тарификации и стоимость рекламных SMS остаются неизменными. Также с указанной даты изменяется ежемесячная абонентская плата за имя отправителя и шаблон клиента для отправки SMS-сообщений в сеть оператора МТС. Новая стоимость указана на сайте на странице Тарифы для оператора МТС (Россия).
    подробнее