• Главная
  • Тарифы
  • Подключение (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)

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

    РАЗНОЕ

    Получение истории отправленных сообщений

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

    ПараметрЗначение
    loginЛогин Клиента.
    pswПароль Клиента или MD5-хеш пароля в нижнем регистре.
    startНачальная дата в периоде, за который запрашивается история. Формат: 'дд.мм.гггг'.
    endКонечная дата в периоде. Если не указана, то возвращаются данные с начальной даты. Формат: 'дд.мм.гггг'.
    phoneНомер или разделенный запятыми список номеров телефонов, для которых необходимо получить историю отправленных SMS-сообщений.
    cntКоличество возвращаемых в ответе сообщений. Максимальное значение равно 100.

    В случае ошибки Сервер возвращает следующую строку:
    • 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Неверный логин или пароль.
    3Сообщение не найдено.
    4IP-адрес временно заблокирован.
    9Попытка отправки более трех одинаковых запросов на получение истории исходящих сообщений в течение минуты.

    В случае успешного запроса Сервер возвращает ответ в виде строки:
    • при fmt = 0:
      Status = <status>, check_time = <last_date>, err = <err>, send_date = <send_date>, phone = <phone>, country = <country>, operator = <operator>, region = <region>, cost = <cost>, sender_id = <sender>, status_name = <status_name>, message = <message>, ID = <id>
      ...

    • при fmt = 1:
      <status>,<last_timestamp>,<err>,<send_timestamp>,<phone>,<country>,<operator>,<region>,<cost>,<sender>,<status_name>,<message>,<id>
      ...

    • при fmt = 2:
      <list>
      <sms>
      <status>status</status>
      <last_date>last_date</last_date>
      <last_timestamp>last_timestamp</last_timestamp>
      <err>err</err>
      <send_date>send_date</send_date>
      <send_timestamp>send_timestamp</send_timestamp>
      <phone>phone</phone>
      <cost>cost</cost>
      <sender_id>sender</sender_id>
      <status_name>status_name</status_name>
      <message>message</message>
      <country>country</country>
      <operator>operator</operator>
      <region>region</region>
      <id>id</id>
      </sms>
      ...
      </list>

    • при fmt = 3:
      [{
      "status": <status>,
      "last_date": "<last_date>",
      "last_timestamp": <last_timestamp>,
      "err": <err>,
      "send_date": "<send_date>",
      "send_timestamp": <send_timestamp>,
      "phone": "<phone>",
      "cost": "<cost>",
      "sender_id": "<sender>",
      "status_name": "<status_name>",
      "message": "<message>",
      "country": "<country>",
      "operator": "<operator>",
      "region": "<region>",
      "id": <id>
      },
      ...]

    Где:
    <status> – код статуса (список)
    <last_date> – дата последнего изменения статуса. Формат DD.MM.YYYY hh:mm:ss.
    <last_timestamp> – штамп времени последнего изменения статуса.
    <err> – код ошибки, если сообщение не было доставлено.
    <send_date> – дата отправки сообщения (формат DD.MM.YYYY hh:mm:ss).
    <send_timestamp> – штамп времени отправки сообщения.
    <phone> – номер телефона абонента.
    <country> – название страны регистрации номера абонента.
    <operator> – название оператора абонента.
    <region> – регион регистрации номера абонента.
    <cost> – стоимость сообщения.
    <sender> – имя отправителя.
    <status_name> – название статуса.
    <message> – текст сообщения.
    <id> – идентификатор сообщения.

    Примеры:

    Получение последних десяти исходящих SMS-сообщений:

    http://billing.smstraf.ru/sys/get.php?get_messages=1&login=alex&psw=123&cnt=10
    Получение последнего исходящего SMS-сообщения, отправленного на номер "79999999999":

    http://billing.smstraf.ru/sys/get.php?get_messages=1&login=alex&psw=123&phone=79999999999

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




    Изменение тарифов на выполнение HLR-запросов в сеть оператора МТС (Россия)
    26.02.2025
    С 1 марта повышаются цены на отправку HLR-запросов абонентам оператора связи МТС (Россия). Новые тарифы указаны на сайте на странице .